// Copyright 2024 Google LLC.

// Use of this source code is governed by a BSD-style

// license that can be found in the LICENSE file.

// Code generated file. DO NOT EDIT.

// Package language provides access to the Cloud Natural Language API.

//

// This package is DEPRECATED. Use package cloud.google.com/go/language/apiv1 instead.

//

// For product documentation, see: https://cloud.google.com/natural-language/

//

// # Library status

//

// These client libraries are officially supported by Google. However, this

// library is considered complete and is in maintenance mode. This means

// that we will address critical bugs and security issues but will not add

// any new features.

//

// When possible, we recommend using our newer

// [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go)

// that are still actively being worked and iterated on.

//

// # Creating a client

//

// Usage example:

//

// import "google.golang.org/api/language/v1"

// ...

// ctx := context.Background()

// languageService, err := language.NewService(ctx)

//

// In this example, Google Application Default Credentials are used for

// authentication. For information on how to create and obtain Application

// Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

//

// # Other authentication options

//

// By default, all available scopes (see "Constants") are used to authenticate.

// To restrict scopes, use [google.golang.org/api/option.WithScopes]:

//

// languageService, err := language.NewService(ctx, option.WithScopes(language.CloudPlatformScope))

//

// To use an API key for authentication (note: some APIs do not support API

// keys), use [google.golang.org/api/option.WithAPIKey]:

//

// languageService, err := language.NewService(ctx, option.WithAPIKey("AIza..."))

//

// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth

// flow, use [google.golang.org/api/option.WithTokenSource]:

//

// config := &oauth2.Config{...}

// // ...

// token, err := config.Exchange(ctx, ...)

// languageService, err := language.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

//

// See [google.golang.org/api/option.ClientOption] for details on options.

package language // import "google.golang.org/api/language/v1"

import (

"bytes"

"context"

"encoding/json"

"errors"

"fmt"

"io"

"net/http"

"net/url"

"strconv"

"strings"

googleapi "google.golang.org/api/googleapi"

internal "google.golang.org/api/internal"

gensupport "google.golang.org/api/internal/gensupport"

option "google.golang.org/api/option"

internaloption "google.golang.org/api/option/internaloption"

htransport "google.golang.org/api/transport/http"

)

// Always reference these packages, just in case the auto-generated code

// below doesn't.

var _ = bytes.NewBuffer

var _ = strconv.Itoa

var _ = fmt.Sprintf

var _ = json.NewDecoder

var _ = io.Copy

var _ = url.Parse

var _ = gensupport.MarshalJSON

var _ = googleapi.Version

var _ = errors.New

var _ = strings.Replace

var _ = context.Canceled

var _ = internaloption.WithDefaultEndpoint

var _ = internal.Version

const apiId = "language:v1"

const apiName = "language"

const apiVersion = "v1"

const basePath = "https://language.googleapis.com/"

const basePathTemplate = "https://language.UNIVERSE_DOMAIN/"

const mtlsBasePath = "https://language.mtls.googleapis.com/"

// OAuth2 scopes used by this API.

const (

// Apply machine learning models to reveal the structure and meaning of text

CloudLanguageScope = "https://www.googleapis.com/auth/cloud-language"

// See, edit, configure, and delete your Google Cloud data and see the email

// address for your Google Account.

CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"

)

// NewService creates a new Service.

func NewService(ctx context.Context, opts ...option.ClientOption) (*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 New(client *http.Client) (*Service, error) {

}

type Service struct {

}

func (s *Service) userAgent() string {

}

func NewDocumentsService(s *Service) *DocumentsService {

rs := &DocumentsService{s: s}

return rs

}

type DocumentsService struct {

s *Service

}

// AnalyzeEntitiesRequest: The entity analysis request message.

type AnalyzeEntitiesRequest struct {

}

func (s *AnalyzeEntitiesRequest) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeEntitiesRequest

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeEntitiesResponse: The entity analysis response message.

type AnalyzeEntitiesResponse struct {

}

func (s *AnalyzeEntitiesResponse) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeEntitiesResponse

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeEntitySentimentRequest: The entity-level sentiment analysis request

// message.

type AnalyzeEntitySentimentRequest struct {

}

func (s *AnalyzeEntitySentimentRequest) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeEntitySentimentRequest

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeEntitySentimentResponse: The entity-level sentiment analysis response

// message.

type AnalyzeEntitySentimentResponse struct {

}

func (s *AnalyzeEntitySentimentResponse) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeEntitySentimentResponse

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeSentimentRequest: The sentiment analysis request message.

type AnalyzeSentimentRequest struct {

}

func (s *AnalyzeSentimentRequest) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeSentimentRequest

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeSentimentResponse: The sentiment analysis response message.

type AnalyzeSentimentResponse struct {

}

func (s *AnalyzeSentimentResponse) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeSentimentResponse

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeSyntaxRequest: The syntax analysis request message.

type AnalyzeSyntaxRequest struct {

}

func (s *AnalyzeSyntaxRequest) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeSyntaxRequest

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnalyzeSyntaxResponse: The syntax analysis response message.

type AnalyzeSyntaxResponse struct {

}

func (s *AnalyzeSyntaxResponse) MarshalJSON() ([]byte, error) {

type NoMethod AnalyzeSyntaxResponse

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnnotateTextRequest: The request message for the text annotation API, which

// can perform multiple analysis types (sentiment, entities, and syntax) in one

// call.

type AnnotateTextRequest struct {

}

func (s *AnnotateTextRequest) MarshalJSON() ([]byte, error) {

type NoMethod AnnotateTextRequest

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnnotateTextRequestFeatures: All available features for sentiment, syntax,

// and semantic analysis. Setting each one to true will enable that specific

// analysis for the input.

type AnnotateTextRequestFeatures struct {

}

func (s *AnnotateTextRequestFeatures) MarshalJSON() ([]byte, error) {

type NoMethod AnnotateTextRequestFeatures

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// AnnotateTextResponse: The text annotations response message.

type AnnotateTextResponse struct {

}

func (s *AnnotateTextResponse) MarshalJSON() ([]byte, error) {

type NoMethod AnnotateTextResponse

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// ClassificationCategory: Represents a category returned from the text

// classifier.

type ClassificationCategory struct {

}

func (s *ClassificationCategory) MarshalJSON() ([]byte, error) {

type NoMethod ClassificationCategory

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

func (s *ClassificationCategory) UnmarshalJSON(data []byte) error {

}

// ClassificationModelOptions: Model options available for classification

// requests.

type ClassificationModelOptions struct {

}

func (s *ClassificationModelOptions) MarshalJSON() ([]byte, error) {

type NoMethod ClassificationModelOptions

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// ClassificationModelOptionsV1Model: Options for the V1 model.

type ClassificationModelOptionsV1Model struct {

}

// ClassificationModelOptionsV2Model: Options for the V2 model.

type ClassificationModelOptionsV2Model struct {

}

func (s *ClassificationModelOptionsV2Model) MarshalJSON() ([]byte, error) {

type NoMethod ClassificationModelOptionsV2Model

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// ClassifyTextRequest: The document classification request message.

type ClassifyTextRequest struct {

}

func (s *ClassifyTextRequest) MarshalJSON() ([]byte, error) {

type NoMethod ClassifyTextRequest

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// ClassifyTextResponse: The document classification response message.

type ClassifyTextResponse struct {

}

func (s *ClassifyTextResponse) MarshalJSON() ([]byte, error) {

type NoMethod ClassifyTextResponse

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

// Color: Represents a color in the RGBA color space. This representation is

// designed for simplicity of conversion to and from color representations in

// various languages over compactness. For example, the fields of this

// representation can be trivially provided to the constructor of

// `java.awt.Color` in Java; it can also be trivially provided to UIColor's

// `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little

// work, it can be easily formatted into a CSS `rgba()` string in JavaScript.

// This reference page doesn't have information about the absolute color space

// that should be used to interpret the RGB value—for example, sRGB, Adobe

// RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB

// color space. When color equality needs to be decided, implementations,

// unless documented otherwise, treat two colors as equal if all their red,

// green, blue, and alpha values each differ by at most `1e-5`. Example (Java):

// import com.google.type.Color; // ... public static java.awt.Color

// fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ?

// protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color(

// protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); }

// public static Color toProto(java.awt.Color color) { float red = (float)

// color.getRed(); float green = (float) color.getGreen(); float blue = (float)

// color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder =

// Color .newBuilder() .setRed(red / denominator) .setGreen(green /

// denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if

// (alpha != 255) { result.setAlpha( FloatValue .newBuilder()

// .setValue(((float) alpha) / denominator) .build()); } return

// resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static

// UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float

// green = [protocolor green]; float blue = [protocolor blue]; FloatValue*

// alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper !=

// nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red

// green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color)

// { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green

// blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc]

// init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue];

// if (alpha <= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; }

// [result autorelease]; return result; } // ... Example (JavaScript): // ...

// var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red ||

// 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue

// || 0.0; var red = Math.floor(redFrac * 255); var green =

// Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if

// (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var

// alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green,

// blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(”);

// }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new

// Number((red << 16) | (green << 8) | blue); var hexString =

// rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var

// resultBuilder = ['#']; for (var i = 0; i < missingZeros; i++) {

// resultBuilder.push('0'); } resultBuilder.push(hexString); return

// resultBuilder.join(”); }; // ...

type Color struct {

}

func (s *Color) MarshalJSON() ([]byte, error) {

type NoMethod Color

return gensupport.MarshalJSON(NoMethod(*s), s.ForceSendFields, s.NullFields)

}

func (s *Color) UnmarshalJSON(data []byte) error {

}

// CpuMetric: Metric for billing reports.

type CpuMetric struct {