OAuth2 scopes used by this API.
const (
// View and manage your data across Google Cloud Platform services
CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
// Translate text from one language to another using Google Translate
CloudTranslationScope = "https://www.googleapis.com/auth/cloud-translation"
)
DetectLanguageRequest: The request message for language detection.
type DetectLanguageRequest struct {
// Q: The input text upon which to perform language detection. Repeat
// this
// parameter to perform language detection on multiple text inputs.
Q []string `json:"q,omitempty"`
// ForceSendFields is a list of field names (e.g. "Q") to unconditionally
// include in API requests. By default, fields with empty or default values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Q") to include in API requests
// with the JSON null value. By default, fields with empty values are omitted
// from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *DetectLanguageRequest) MarshalJSON() ([]byte, error)
type DetectionsDetectCall struct {
// contains filtered or unexported fields
}
func (c *DetectionsDetectCall) Context(ctx context.Context) *DetectionsDetectCall
Context sets the context to be used in this call's Do method.
func (c *DetectionsDetectCall) Do(opts ...googleapi.CallOption) (*DetectionsListResponse, error)
Do executes the "language.detections.detect" call. Any non-2xx status code is an error. Response headers are in either *DetectionsListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DetectionsDetectCall) Fields(s ...googleapi.Field) *DetectionsDetectCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.
func (c *DetectionsDetectCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
type DetectionsListCall struct {
// contains filtered or unexported fields
}
func (c *DetectionsListCall) Context(ctx context.Context) *DetectionsListCall
Context sets the context to be used in this call's Do method.
func (c *DetectionsListCall) Do(opts ...googleapi.CallOption) (*DetectionsListResponse, error)
Do executes the "language.detections.list" call. Any non-2xx status code is an error. Response headers are in either *DetectionsListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DetectionsListCall) Fields(s ...googleapi.Field) *DetectionsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.
func (c *DetectionsListCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
func (c *DetectionsListCall) IfNoneMatch(entityTag string) *DetectionsListCall
IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.
type DetectionsListResponse struct {
// Detections: A detections contains detection results of several text
Detections [][]*DetectionsResourceItem `json:"detections,omitempty"`
// ServerResponse contains the HTTP response code and headers from the server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Detections") to
// unconditionally include in API requests. By default, fields with empty or
// default values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Detections") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *DetectionsListResponse) MarshalJSON() ([]byte, error)
type DetectionsResourceItem struct {
// Confidence: The confidence of the detection result of this language.
Confidence float64 `json:"confidence,omitempty"`
// IsReliable: A boolean to indicate is the language detection result reliable.
IsReliable bool `json:"isReliable,omitempty"`
// Language: The language we detected.
Language string `json:"language,omitempty"`
// ForceSendFields is a list of field names (e.g. "Confidence") to
// unconditionally include in API requests. By default, fields with empty or
// default values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Confidence") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *DetectionsResourceItem) MarshalJSON() ([]byte, error)
func (s *DetectionsResourceItem) UnmarshalJSON(data []byte) error
type DetectionsService struct {
// contains filtered or unexported fields
}
func NewDetectionsService(s *Service) *DetectionsService
func (r *DetectionsService) Detect(detectlanguagerequest *DetectLanguageRequest) *DetectionsDetectCall
Detect: Detects the language of text within a request.
func (r *DetectionsService) List(q []string) *DetectionsListCall
List: Detects the language of text within a request.
parameter to perform language detection on multiple text inputs.
GetSupportedLanguagesRequest: The request message for discovering supported languages.
type GetSupportedLanguagesRequest struct {
// Target: The language to use to return localized, human readable names of
// supported
// languages.
Target string `json:"target,omitempty"`
// ForceSendFields is a list of field names (e.g. "Target") to unconditionally
// include in API requests. By default, fields with empty or default values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Target") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *GetSupportedLanguagesRequest) MarshalJSON() ([]byte, error)
type LanguagesListCall struct {
// contains filtered or unexported fields
}
func (c *LanguagesListCall) Context(ctx context.Context) *LanguagesListCall
Context sets the context to be used in this call's Do method.
func (c *LanguagesListCall) Do(opts ...googleapi.CallOption) (*LanguagesListResponse, error)
Do executes the "language.languages.list" call. Any non-2xx status code is an error. Response headers are in either *LanguagesListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *LanguagesListCall) Fields(s ...googleapi.Field) *LanguagesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.
func (c *LanguagesListCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
func (c *LanguagesListCall) IfNoneMatch(entityTag string) *LanguagesListCall
IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.
func (c *LanguagesListCall) Model(model string) *LanguagesListCall
Model sets the optional parameter "model": The model type for which supported languages should be returned.
func (c *LanguagesListCall) Target(target string) *LanguagesListCall
Target sets the optional parameter "target": The language to use to return localized, human readable names of supported languages.
type LanguagesListResponse struct {
// Languages: List of source/target languages supported by the translation API.
// If target parameter is unspecified, the list is sorted by the ASCII code
// point order of the language code. If target parameter is specified, the list
// is sorted by the collation order of the language name in the target
// language.
Languages []*LanguagesResource `json:"languages,omitempty"`
// ServerResponse contains the HTTP response code and headers from the server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Languages") to
// unconditionally include in API requests. By default, fields with empty or
// default values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Languages") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *LanguagesListResponse) MarshalJSON() ([]byte, error)
type LanguagesResource struct {
// Language: Supported language code, generally consisting of its ISO
// 639-1
// identifier. (E.g. 'en', 'ja'). In certain cases, BCP-47 codes
// including
// language + region identifiers are returned (e.g. 'zh-TW' and 'zh-CH')
Language string `json:"language,omitempty"`
// Name: Human readable name of the language localized to the target language.
Name string `json:"name,omitempty"`
// ForceSendFields is a list of field names (e.g. "Language") to
// unconditionally include in API requests. By default, fields with empty or
// default values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Language") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *LanguagesResource) MarshalJSON() ([]byte, error)
type LanguagesService struct {
// contains filtered or unexported fields
}
func NewLanguagesService(s *Service) *LanguagesService
func (r *LanguagesService) List() *LanguagesListCall
List: Returns a list of supported languages for translation.
type Service struct {
BasePath string // API endpoint base URL
UserAgent string // optional additional User-Agent fragment
Detections *DetectionsService
Languages *LanguagesService
Translations *TranslationsService
// contains filtered or unexported fields
}
func New(client *http.Client) (*Service, error)
New creates a new Service. It uses the provided http.Client for requests.
Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.
func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)
NewService creates a new Service.
TranslateTextRequest: The main translation request message for the Cloud Translation API.
type TranslateTextRequest struct {
// Format: The format of the source text, in either HTML (default) or
// plain-text. A
// value of "html" indicates HTML and a value of "text" indicates plain-text.
Format string `json:"format,omitempty"`
// Model: The `model` type requested for this translation. Valid values
// are
// listed in public documentation.
Model string `json:"model,omitempty"`
// Q: The input text to translate. Repeat this parameter to perform
// translation
// operations on multiple text inputs.
Q []string `json:"q,omitempty"`
// Source: The language of the source text, set to one of the language codes
// listed in
// Language Support. If the source language is not specified, the API
// will
// attempt to identify the source language automatically and return it
// within
// the response.
Source string `json:"source,omitempty"`
// Target: The language to use for translation of the input text, set to one of
// the
// language codes listed in Language Support.
Target string `json:"target,omitempty"`
// ForceSendFields is a list of field names (e.g. "Format") to unconditionally
// include in API requests. By default, fields with empty or default values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Format") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *TranslateTextRequest) MarshalJSON() ([]byte, error)
type TranslationsListCall struct {
// contains filtered or unexported fields
}
func (c *TranslationsListCall) Cid(cid ...string) *TranslationsListCall
Cid sets the optional parameter "cid": The customization id for translate
func (c *TranslationsListCall) Context(ctx context.Context) *TranslationsListCall
Context sets the context to be used in this call's Do method.
func (c *TranslationsListCall) Do(opts ...googleapi.CallOption) (*TranslationsListResponse, error)
Do executes the "language.translations.list" call. Any non-2xx status code is an error. Response headers are in either *TranslationsListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TranslationsListCall) Fields(s ...googleapi.Field) *TranslationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.
func (c *TranslationsListCall) Format(format string) *TranslationsListCall
Format sets the optional parameter "format": The format of the source text, in either HTML (default) or plain-text. A value of "html" indicates HTML and a value of "text" indicates plain-text.
Possible values:
"html" - Specifies the input is in HTML "text" - Specifies the input is in plain textual format
func (c *TranslationsListCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
func (c *TranslationsListCall) IfNoneMatch(entityTag string) *TranslationsListCall
IfNoneMatch sets an optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request.
func (c *TranslationsListCall) Model(model string) *TranslationsListCall
Model sets the optional parameter "model": The `model` type requested for this translation. Valid values are listed in public documentation.
func (c *TranslationsListCall) Source(source string) *TranslationsListCall
Source sets the optional parameter "source": The language of the source text, set to one of the language codes listed in Language Support. If the source language is not specified, the API will attempt to identify the source language automatically and return it within the response.
TranslationsListResponse: The main language translation response message.
type TranslationsListResponse struct {
// Translations: Translations contains list of translation results of given
// text
Translations []*TranslationsResource `json:"translations,omitempty"`
// ServerResponse contains the HTTP response code and headers from the server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Translations") to
// unconditionally include in API requests. By default, fields with empty or
// default values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Translations") to include in API
// requests with the JSON null value. By default, fields with empty values are
// omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *TranslationsListResponse) MarshalJSON() ([]byte, error)
type TranslationsResource struct {
// DetectedSourceLanguage: The source language of the initial request, detected
// automatically, if
// no source language was passed within the initial request. If the
// source language was passed, auto-detection of the language will not
// occur and this field will be empty.
DetectedSourceLanguage string `json:"detectedSourceLanguage,omitempty"`
// Model: The `model` type used for this translation. Valid values are
// listed in public documentation. Can be different from requested
// `model`.
// Present only if specific model type was explicitly requested.
Model string `json:"model,omitempty"`
// TranslatedText: Text translated into the target language.
TranslatedText string `json:"translatedText,omitempty"`
// ForceSendFields is a list of field names (e.g. "DetectedSourceLanguage") to
// unconditionally include in API requests. By default, fields with empty or
// default values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
// details.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DetectedSourceLanguage") to
// include in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. See
// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
NullFields []string `json:"-"`
}
func (s *TranslationsResource) MarshalJSON() ([]byte, error)
type TranslationsService struct {
// contains filtered or unexported fields
}
func NewTranslationsService(s *Service) *TranslationsService
func (r *TranslationsService) List(q []string, target string) *TranslationsListCall
List: Translates input text, returning translated text.
operations on multiple text inputs.
language codes listed in Language Support.
func (r *TranslationsService) Translate(translatetextrequest *TranslateTextRequest) *TranslationsTranslateCall
Translate: Translates input text, returning translated text.
type TranslationsTranslateCall struct {
// contains filtered or unexported fields
}
func (c *TranslationsTranslateCall) Context(ctx context.Context) *TranslationsTranslateCall
Context sets the context to be used in this call's Do method.
func (c *TranslationsTranslateCall) Do(opts ...googleapi.CallOption) (*TranslationsListResponse, error)
Do executes the "language.translations.translate" call. Any non-2xx status code is an error. Response headers are in either *TranslationsListResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TranslationsTranslateCall) Fields(s ...googleapi.Field) *TranslationsTranslateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.
func (c *TranslationsTranslateCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.