discovery - ActiveState ActiveGo 1.8
...

Package discovery

import "google.golang.org/api/discovery/v1"
Overview
Index

Overview ▾

Package discovery provides access to the APIs Discovery Service.

See https://developers.google.com/discovery/

Usage example:

import "google.golang.org/api/discovery/v1"
...
discoveryService, err := discovery.New(oauthHttpClient)

Index ▾

type ApisGetRestCall
    func (c *ApisGetRestCall) Context(ctx context.Context) *ApisGetRestCall
    func (c *ApisGetRestCall) Do(opts ...googleapi.CallOption) (*RestDescription, error)
    func (c *ApisGetRestCall) Fields(s ...googleapi.Field) *ApisGetRestCall
    func (c *ApisGetRestCall) Header() http.Header
    func (c *ApisGetRestCall) IfNoneMatch(entityTag string) *ApisGetRestCall
type ApisListCall
    func (c *ApisListCall) Context(ctx context.Context) *ApisListCall
    func (c *ApisListCall) Do(opts ...googleapi.CallOption) (*DirectoryList, error)
    func (c *ApisListCall) Fields(s ...googleapi.Field) *ApisListCall
    func (c *ApisListCall) Header() http.Header
    func (c *ApisListCall) IfNoneMatch(entityTag string) *ApisListCall
    func (c *ApisListCall) Name(name string) *ApisListCall
    func (c *ApisListCall) Preferred(preferred bool) *ApisListCall
type ApisService
    func NewApisService(s *Service) *ApisService
    func (r *ApisService) GetRest(api string, version string) *ApisGetRestCall
    func (r *ApisService) List() *ApisListCall
type DirectoryList
    func (s *DirectoryList) MarshalJSON() ([]byte, error)
type DirectoryListItems
    func (s *DirectoryListItems) MarshalJSON() ([]byte, error)
type DirectoryListItemsIcons
    func (s *DirectoryListItemsIcons) MarshalJSON() ([]byte, error)
type JsonSchema
    func (s *JsonSchema) MarshalJSON() ([]byte, error)
type JsonSchemaAnnotations
    func (s *JsonSchemaAnnotations) MarshalJSON() ([]byte, error)
type JsonSchemaVariant
    func (s *JsonSchemaVariant) MarshalJSON() ([]byte, error)
type JsonSchemaVariantMap
    func (s *JsonSchemaVariantMap) MarshalJSON() ([]byte, error)
type RestDescription
    func (s *RestDescription) MarshalJSON() ([]byte, error)
type RestDescriptionAuth
    func (s *RestDescriptionAuth) MarshalJSON() ([]byte, error)
type RestDescriptionAuthOauth2
    func (s *RestDescriptionAuthOauth2) MarshalJSON() ([]byte, error)
type RestDescriptionAuthOauth2Scopes
    func (s *RestDescriptionAuthOauth2Scopes) MarshalJSON() ([]byte, error)
type RestDescriptionIcons
    func (s *RestDescriptionIcons) MarshalJSON() ([]byte, error)
type RestMethod
    func (s *RestMethod) MarshalJSON() ([]byte, error)
type RestMethodMediaUpload
    func (s *RestMethodMediaUpload) MarshalJSON() ([]byte, error)
type RestMethodMediaUploadProtocols
    func (s *RestMethodMediaUploadProtocols) MarshalJSON() ([]byte, error)
type RestMethodMediaUploadProtocolsResumable
    func (s *RestMethodMediaUploadProtocolsResumable) MarshalJSON() ([]byte, error)
type RestMethodMediaUploadProtocolsSimple
    func (s *RestMethodMediaUploadProtocolsSimple) MarshalJSON() ([]byte, error)
type RestMethodRequest
    func (s *RestMethodRequest) MarshalJSON() ([]byte, error)
type RestMethodResponse
    func (s *RestMethodResponse) MarshalJSON() ([]byte, error)
type RestResource
    func (s *RestResource) MarshalJSON() ([]byte, error)
type Service
    func New(client *http.Client) (*Service, error)

Package files

discovery-gen.go

type ApisGetRestCall

type ApisGetRestCall struct {
    // contains filtered or unexported fields
}

func (*ApisGetRestCall) Context

func (c *ApisGetRestCall) Context(ctx context.Context) *ApisGetRestCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ApisGetRestCall) Do

func (c *ApisGetRestCall) Do(opts ...googleapi.CallOption) (*RestDescription, error)

Do executes the "discovery.apis.getRest" call. Exactly one of *RestDescription or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RestDescription.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 (*ApisGetRestCall) Fields

func (c *ApisGetRestCall) Fields(s ...googleapi.Field) *ApisGetRestCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ApisGetRestCall) Header

func (c *ApisGetRestCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ApisGetRestCall) IfNoneMatch

func (c *ApisGetRestCall) IfNoneMatch(entityTag string) *ApisGetRestCall

IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

type ApisListCall

type ApisListCall struct {
    // contains filtered or unexported fields
}

func (*ApisListCall) Context

func (c *ApisListCall) Context(ctx context.Context) *ApisListCall

Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.

func (*ApisListCall) Do

func (c *ApisListCall) Do(opts ...googleapi.CallOption) (*DirectoryList, error)

Do executes the "discovery.apis.list" call. Exactly one of *DirectoryList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DirectoryList.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 (*ApisListCall) Fields

func (c *ApisListCall) Fields(s ...googleapi.Field) *ApisListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.

func (*ApisListCall) Header

func (c *ApisListCall) Header() http.Header

Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.

func (*ApisListCall) IfNoneMatch

func (c *ApisListCall) IfNoneMatch(entityTag string) *ApisListCall

IfNoneMatch sets the 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. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.

func (*ApisListCall) Name

func (c *ApisListCall) Name(name string) *ApisListCall

Name sets the optional parameter "name": Only include APIs with the given name.

func (*ApisListCall) Preferred

func (c *ApisListCall) Preferred(preferred bool) *ApisListCall

Preferred sets the optional parameter "preferred": Return only the preferred version of an API.

type ApisService

type ApisService struct {
    // contains filtered or unexported fields
}

func NewApisService

func NewApisService(s *Service) *ApisService

func (*ApisService) GetRest

func (r *ApisService) GetRest(api string, version string) *ApisGetRestCall

GetRest: Retrieve the description of a particular version of an api.

func (*ApisService) List

func (r *ApisService) List() *ApisListCall

List: Retrieve the list of APIs supported at this endpoint.

type DirectoryList

type DirectoryList struct {
    // DiscoveryVersion: Indicate the version of the Discovery API used to
    // generate this doc.
    DiscoveryVersion string `json:"discoveryVersion,omitempty"`

    // Items: The individual directory entries. One entry per api/version
    // pair.
    Items []*DirectoryListItems `json:"items,omitempty"`

    // Kind: The kind for this response.
    Kind string `json:"kind,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "DiscoveryVersion") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "DiscoveryVersion") to
    // include in API requests with the JSON null value. By default, fields
    // with empty values are omitted from API requests. However, any field
    // with an empty value appearing in NullFields will be sent to the
    // server as null. It is an error if a field in this list has a
    // non-empty value. This may be used to include null fields in Patch
    // requests.
    NullFields []string `json:"-"`
}

func (*DirectoryList) MarshalJSON

func (s *DirectoryList) MarshalJSON() ([]byte, error)

type DirectoryListItems

type DirectoryListItems struct {
    // Description: The description of this API.
    Description string `json:"description,omitempty"`

    // DiscoveryLink: A link to the discovery document.
    DiscoveryLink string `json:"discoveryLink,omitempty"`

    // DiscoveryRestUrl: The URL for the discovery REST document.
    DiscoveryRestUrl string `json:"discoveryRestUrl,omitempty"`

    // DocumentationLink: A link to human readable documentation for the
    // API.
    DocumentationLink string `json:"documentationLink,omitempty"`

    // Icons: Links to 16x16 and 32x32 icons representing the API.
    Icons *DirectoryListItemsIcons `json:"icons,omitempty"`

    // Id: The id of this API.
    Id string `json:"id,omitempty"`

    // Kind: The kind for this response.
    Kind string `json:"kind,omitempty"`

    // Labels: Labels for the status of this API, such as labs or
    // deprecated.
    Labels []string `json:"labels,omitempty"`

    // Name: The name of the API.
    Name string `json:"name,omitempty"`

    // Preferred: True if this version is the preferred version to use.
    Preferred bool `json:"preferred,omitempty"`

    // Title: The title of this API.
    Title string `json:"title,omitempty"`

    // Version: The version of the API.
    Version string `json:"version,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Description") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Description") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*DirectoryListItems) MarshalJSON

func (s *DirectoryListItems) MarshalJSON() ([]byte, error)

type DirectoryListItemsIcons

DirectoryListItemsIcons: Links to 16x16 and 32x32 icons representing the API.

type DirectoryListItemsIcons struct {
    // X16: The URL of the 16x16 icon.
    X16 string `json:"x16,omitempty"`

    // X32: The URL of the 32x32 icon.
    X32 string `json:"x32,omitempty"`

    // ForceSendFields is a list of field names (e.g. "X16") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "X16") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*DirectoryListItemsIcons) MarshalJSON

func (s *DirectoryListItemsIcons) MarshalJSON() ([]byte, error)

type JsonSchema

type JsonSchema struct {
    // Ref: A reference to another schema. The value of this property is the
    // "id" of another schema.
    Ref string `json:"$ref,omitempty"`

    // AdditionalProperties: If this is a schema for an object, this
    // property is the schema for any additional properties with dynamic
    // keys on this object.
    AdditionalProperties *JsonSchema `json:"additionalProperties,omitempty"`

    // Annotations: Additional information about this property.
    Annotations *JsonSchemaAnnotations `json:"annotations,omitempty"`

    // Default: The default value of this property (if one exists).
    Default string `json:"default,omitempty"`

    // Description: A description of this object.
    Description string `json:"description,omitempty"`

    // Enum: Values this parameter may take (if it is an enum).
    Enum []string `json:"enum,omitempty"`

    // EnumDescriptions: The descriptions for the enums. Each position maps
    // to the corresponding value in the "enum" array.
    EnumDescriptions []string `json:"enumDescriptions,omitempty"`

    // Format: An additional regular expression or key that helps constrain
    // the value. For more details see:
    // http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.23
    Format string `json:"format,omitempty"`

    // Id: Unique identifier for this schema.
    Id string `json:"id,omitempty"`

    // Items: If this is a schema for an array, this property is the schema
    // for each element in the array.
    Items *JsonSchema `json:"items,omitempty"`

    // Location: Whether this parameter goes in the query or the path for
    // REST requests.
    Location string `json:"location,omitempty"`

    // Maximum: The maximum value of this parameter.
    Maximum string `json:"maximum,omitempty"`

    // Minimum: The minimum value of this parameter.
    Minimum string `json:"minimum,omitempty"`

    // Pattern: The regular expression this parameter must conform to. Uses
    // Java 6 regex format:
    // http://docs.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html
    Pattern string `json:"pattern,omitempty"`

    // Properties: If this is a schema for an object, list the schema for
    // each property of this object.
    Properties map[string]JsonSchema `json:"properties,omitempty"`

    // ReadOnly: The value is read-only, generated by the service. The value
    // cannot be modified by the client. If the value is included in a POST,
    // PUT, or PATCH request, it is ignored by the service.
    ReadOnly bool `json:"readOnly,omitempty"`

    // Repeated: Whether this parameter may appear multiple times.
    Repeated bool `json:"repeated,omitempty"`

    // Required: Whether the parameter is required.
    Required bool `json:"required,omitempty"`

    // Type: The value type for this schema. A list of values can be found
    // here: http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5.1
    Type string `json:"type,omitempty"`

    // Variant: In a variant data type, the value of one property is used to
    // determine how to interpret the entire entity. Its value must exist in
    // a map of descriminant values to schema names.
    Variant *JsonSchemaVariant `json:"variant,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Ref") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Ref") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*JsonSchema) MarshalJSON

func (s *JsonSchema) MarshalJSON() ([]byte, error)

type JsonSchemaAnnotations

JsonSchemaAnnotations: Additional information about this property.

type JsonSchemaAnnotations struct {
    // Required: A list of methods for which this property is required on
    // requests.
    Required []string `json:"required,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Required") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Required") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*JsonSchemaAnnotations) MarshalJSON

func (s *JsonSchemaAnnotations) MarshalJSON() ([]byte, error)

type JsonSchemaVariant

JsonSchemaVariant: In a variant data type, the value of one property is used to determine how to interpret the entire entity. Its value must exist in a map of descriminant values to schema names.

type JsonSchemaVariant struct {
    // Discriminant: The name of the type discriminant property.
    Discriminant string `json:"discriminant,omitempty"`

    // Map: The map of discriminant value to schema to use for parsing..
    Map []*JsonSchemaVariantMap `json:"map,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Discriminant") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Discriminant") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*JsonSchemaVariant) MarshalJSON

func (s *JsonSchemaVariant) MarshalJSON() ([]byte, error)

type JsonSchemaVariantMap

type JsonSchemaVariantMap struct {
    Ref string `json:"$ref,omitempty"`

    TypeValue string `json:"type_value,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Ref") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Ref") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*JsonSchemaVariantMap) MarshalJSON

func (s *JsonSchemaVariantMap) MarshalJSON() ([]byte, error)

type RestDescription

type RestDescription struct {
    // Auth: Authentication information.
    Auth *RestDescriptionAuth `json:"auth,omitempty"`

    // BasePath: [DEPRECATED] The base path for REST requests.
    BasePath string `json:"basePath,omitempty"`

    // BaseUrl: [DEPRECATED] The base URL for REST requests.
    BaseUrl string `json:"baseUrl,omitempty"`

    // BatchPath: The path for REST batch requests.
    BatchPath string `json:"batchPath,omitempty"`

    // CanonicalName: Indicates how the API name should be capitalized and
    // split into various parts. Useful for generating pretty class names.
    CanonicalName string `json:"canonicalName,omitempty"`

    // Description: The description of this API.
    Description string `json:"description,omitempty"`

    // DiscoveryVersion: Indicate the version of the Discovery API used to
    // generate this doc.
    DiscoveryVersion string `json:"discoveryVersion,omitempty"`

    // DocumentationLink: A link to human readable documentation for the
    // API.
    DocumentationLink string `json:"documentationLink,omitempty"`

    // Etag: The ETag for this response.
    Etag string `json:"etag,omitempty"`

    // ExponentialBackoffDefault: Enable exponential backoff for suitable
    // methods in the generated clients.
    ExponentialBackoffDefault bool `json:"exponentialBackoffDefault,omitempty"`

    // Features: A list of supported features for this API.
    Features []string `json:"features,omitempty"`

    // Icons: Links to 16x16 and 32x32 icons representing the API.
    Icons *RestDescriptionIcons `json:"icons,omitempty"`

    // Id: The ID of this API.
    Id string `json:"id,omitempty"`

    // Kind: The kind for this response.
    Kind string `json:"kind,omitempty"`

    // Labels: Labels for the status of this API, such as labs or
    // deprecated.
    Labels []string `json:"labels,omitempty"`

    // Methods: API-level methods for this API.
    Methods map[string]RestMethod `json:"methods,omitempty"`

    // Name: The name of this API.
    Name string `json:"name,omitempty"`

    // OwnerDomain: The domain of the owner of this API. Together with the
    // ownerName and a packagePath values, this can be used to generate a
    // library for this API which would have a unique fully qualified name.
    OwnerDomain string `json:"ownerDomain,omitempty"`

    // OwnerName: The name of the owner of this API. See ownerDomain.
    OwnerName string `json:"ownerName,omitempty"`

    // PackagePath: The package of the owner of this API. See ownerDomain.
    PackagePath string `json:"packagePath,omitempty"`

    // Parameters: Common parameters that apply across all apis.
    Parameters map[string]JsonSchema `json:"parameters,omitempty"`

    // Protocol: The protocol described by this document.
    Protocol string `json:"protocol,omitempty"`

    // Resources: The resources in this API.
    Resources map[string]RestResource `json:"resources,omitempty"`

    // Revision: The version of this API.
    Revision string `json:"revision,omitempty"`

    // RootUrl: The root URL under which all API services live.
    RootUrl string `json:"rootUrl,omitempty"`

    // Schemas: The schemas for this API.
    Schemas map[string]JsonSchema `json:"schemas,omitempty"`

    // ServicePath: The base path for all REST requests.
    ServicePath string `json:"servicePath,omitempty"`

    // Title: The title of this API.
    Title string `json:"title,omitempty"`

    // Version: The version of this API.
    Version string `json:"version,omitempty"`

    VersionModule bool `json:"version_module,omitempty"`

    // ServerResponse contains the HTTP response code and headers from the
    // server.
    googleapi.ServerResponse `json:"-"`

    // ForceSendFields is a list of field names (e.g. "Auth") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Auth") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestDescription) MarshalJSON

func (s *RestDescription) MarshalJSON() ([]byte, error)

type RestDescriptionAuth

RestDescriptionAuth: Authentication information.

type RestDescriptionAuth struct {
    // Oauth2: OAuth 2.0 authentication information.
    Oauth2 *RestDescriptionAuthOauth2 `json:"oauth2,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Oauth2") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Oauth2") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestDescriptionAuth) MarshalJSON

func (s *RestDescriptionAuth) MarshalJSON() ([]byte, error)

type RestDescriptionAuthOauth2

RestDescriptionAuthOauth2: OAuth 2.0 authentication information.

type RestDescriptionAuthOauth2 struct {
    // Scopes: Available OAuth 2.0 scopes.
    Scopes map[string]RestDescriptionAuthOauth2Scopes `json:"scopes,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Scopes") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Scopes") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestDescriptionAuthOauth2) MarshalJSON

func (s *RestDescriptionAuthOauth2) MarshalJSON() ([]byte, error)

type RestDescriptionAuthOauth2Scopes

RestDescriptionAuthOauth2Scopes: The scope value.

type RestDescriptionAuthOauth2Scopes struct {
    // Description: Description of scope.
    Description string `json:"description,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Description") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Description") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestDescriptionAuthOauth2Scopes) MarshalJSON

func (s *RestDescriptionAuthOauth2Scopes) MarshalJSON() ([]byte, error)

type RestDescriptionIcons

RestDescriptionIcons: Links to 16x16 and 32x32 icons representing the API.

type RestDescriptionIcons struct {
    // X16: The URL of the 16x16 icon.
    X16 string `json:"x16,omitempty"`

    // X32: The URL of the 32x32 icon.
    X32 string `json:"x32,omitempty"`

    // ForceSendFields is a list of field names (e.g. "X16") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "X16") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestDescriptionIcons) MarshalJSON

func (s *RestDescriptionIcons) MarshalJSON() ([]byte, error)

type RestMethod

type RestMethod struct {
    // Description: Description of this method.
    Description string `json:"description,omitempty"`

    // EtagRequired: Whether this method requires an ETag to be specified.
    // The ETag is sent as an HTTP If-Match or If-None-Match header.
    EtagRequired bool `json:"etagRequired,omitempty"`

    // HttpMethod: HTTP method used by this method.
    HttpMethod string `json:"httpMethod,omitempty"`

    // Id: A unique ID for this method. This property can be used to match
    // methods between different versions of Discovery.
    Id string `json:"id,omitempty"`

    // MediaUpload: Media upload parameters.
    MediaUpload *RestMethodMediaUpload `json:"mediaUpload,omitempty"`

    // ParameterOrder: Ordered list of required parameters, serves as a hint
    // to clients on how to structure their method signatures. The array is
    // ordered such that the "most-significant" parameter appears first.
    ParameterOrder []string `json:"parameterOrder,omitempty"`

    // Parameters: Details for all parameters in this method.
    Parameters map[string]JsonSchema `json:"parameters,omitempty"`

    // Path: The URI path of this REST method. Should be used in conjunction
    // with the basePath property at the api-level.
    Path string `json:"path,omitempty"`

    // Request: The schema for the request.
    Request *RestMethodRequest `json:"request,omitempty"`

    // Response: The schema for the response.
    Response *RestMethodResponse `json:"response,omitempty"`

    // Scopes: OAuth 2.0 scopes applicable to this method.
    Scopes []string `json:"scopes,omitempty"`

    // SupportsMediaDownload: Whether this method supports media downloads.
    SupportsMediaDownload bool `json:"supportsMediaDownload,omitempty"`

    // SupportsMediaUpload: Whether this method supports media uploads.
    SupportsMediaUpload bool `json:"supportsMediaUpload,omitempty"`

    // SupportsSubscription: Whether this method supports subscriptions.
    SupportsSubscription bool `json:"supportsSubscription,omitempty"`

    // UseMediaDownloadService: Indicates that downloads from this method
    // should use the download service URL (i.e. "/download"). Only applies
    // if the method supports media download.
    UseMediaDownloadService bool `json:"useMediaDownloadService,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Description") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Description") to include
    // in API requests with the JSON null value. By default, fields with
    // empty values are omitted from API requests. However, any field with
    // an empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethod) MarshalJSON

func (s *RestMethod) MarshalJSON() ([]byte, error)

type RestMethodMediaUpload

RestMethodMediaUpload: Media upload parameters.

type RestMethodMediaUpload struct {
    // Accept: MIME Media Ranges for acceptable media uploads to this
    // method.
    Accept []string `json:"accept,omitempty"`

    // MaxSize: Maximum size of a media upload, such as "1MB", "2GB" or
    // "3TB".
    MaxSize string `json:"maxSize,omitempty"`

    // Protocols: Supported upload protocols.
    Protocols *RestMethodMediaUploadProtocols `json:"protocols,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Accept") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Accept") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethodMediaUpload) MarshalJSON

func (s *RestMethodMediaUpload) MarshalJSON() ([]byte, error)

type RestMethodMediaUploadProtocols

RestMethodMediaUploadProtocols: Supported upload protocols.

type RestMethodMediaUploadProtocols struct {
    // Resumable: Supports the Resumable Media Upload protocol.
    Resumable *RestMethodMediaUploadProtocolsResumable `json:"resumable,omitempty"`

    // Simple: Supports uploading as a single HTTP request.
    Simple *RestMethodMediaUploadProtocolsSimple `json:"simple,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Resumable") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Resumable") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethodMediaUploadProtocols) MarshalJSON

func (s *RestMethodMediaUploadProtocols) MarshalJSON() ([]byte, error)

type RestMethodMediaUploadProtocolsResumable

RestMethodMediaUploadProtocolsResumable: Supports the Resumable Media Upload protocol.

type RestMethodMediaUploadProtocolsResumable struct {
    // Multipart: True if this endpoint supports uploading multipart media.
    //
    // Default: true
    Multipart *bool `json:"multipart,omitempty"`

    // Path: The URI path to be used for upload. Should be used in
    // conjunction with the basePath property at the api-level.
    Path string `json:"path,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Multipart") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Multipart") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethodMediaUploadProtocolsResumable) MarshalJSON

func (s *RestMethodMediaUploadProtocolsResumable) MarshalJSON() ([]byte, error)

type RestMethodMediaUploadProtocolsSimple

RestMethodMediaUploadProtocolsSimple: Supports uploading as a single HTTP request.

type RestMethodMediaUploadProtocolsSimple struct {
    // Multipart: True if this endpoint supports upload multipart media.
    //
    // Default: true
    Multipart *bool `json:"multipart,omitempty"`

    // Path: The URI path to be used for upload. Should be used in
    // conjunction with the basePath property at the api-level.
    Path string `json:"path,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Multipart") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Multipart") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethodMediaUploadProtocolsSimple) MarshalJSON

func (s *RestMethodMediaUploadProtocolsSimple) MarshalJSON() ([]byte, error)

type RestMethodRequest

RestMethodRequest: The schema for the request.

type RestMethodRequest struct {
    // Ref: Schema ID for the request schema.
    Ref string `json:"$ref,omitempty"`

    // ParameterName: parameter name.
    ParameterName string `json:"parameterName,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Ref") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Ref") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethodRequest) MarshalJSON

func (s *RestMethodRequest) MarshalJSON() ([]byte, error)

type RestMethodResponse

RestMethodResponse: The schema for the response.

type RestMethodResponse struct {
    // Ref: Schema ID for the response schema.
    Ref string `json:"$ref,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Ref") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Ref") to include in API
    // requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestMethodResponse) MarshalJSON

func (s *RestMethodResponse) MarshalJSON() ([]byte, error)

type RestResource

type RestResource struct {
    // Methods: Methods on this resource.
    Methods map[string]RestMethod `json:"methods,omitempty"`

    // Resources: Sub-resources on this resource.
    Resources map[string]RestResource `json:"resources,omitempty"`

    // ForceSendFields is a list of field names (e.g. "Methods") to
    // unconditionally include in API requests. By default, fields with
    // empty values are omitted from API requests. However, any non-pointer,
    // non-interface field appearing in ForceSendFields will be sent to the
    // server regardless of whether the field is empty or not. This may be
    // used to include empty fields in Patch requests.
    ForceSendFields []string `json:"-"`

    // NullFields is a list of field names (e.g. "Methods") to include in
    // API requests with the JSON null value. By default, fields with empty
    // values are omitted from API requests. However, any field with an
    // empty value appearing in NullFields will be sent to the server as
    // null. It is an error if a field in this list has a non-empty value.
    // This may be used to include null fields in Patch requests.
    NullFields []string `json:"-"`
}

func (*RestResource) MarshalJSON

func (s *RestResource) MarshalJSON() ([]byte, error)

type Service

type Service struct {
    BasePath  string // API endpoint base URL
    UserAgent string // optional additional User-Agent fragment

    Apis *ApisService
    // contains filtered or unexported fields
}

func New

func New(client *http.Client) (*Service, error)