run/v1/run-gen.go - google-api-go-client - Git at Google

 // Copyright 2019 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 run provides access to the Cloud Run API.
 //
 // For product documentation, see: https://cloud.google.com/run/
 //
 // Creating a client
 //
 // Usage example:
 //
 //   import "google.golang.org/api/run/v1"
 //   ...
 //   ctx := context.Background()
 //   runService, err := run.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
 //
 // To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
 //
 //   runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
 //
 // To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
 //
 //   config := &oauth2.Config{...}
 //   // ...
 //   token, err := config.Exchange(ctx, ...)
 //   runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
 //
 // See https://godoc.org/google.golang.org/api/option/ for details on options.
 package run // import "google.golang.org/api/run/v1"

 import (
 	"bytes"
 	"context"
 	"encoding/json"
 	"errors"
 	"fmt"
 	"io"
 	"net/http"
 	"net/url"
 	"strconv"
 	"strings"

 	googleapi "google.golang.org/api/googleapi"
 	gensupport "google.golang.org/api/internal/gensupport"
 	option "google.golang.org/api/option"
 	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

 const apiId = "run:v1"
 const apiName = "run"
 const apiVersion = "v1"
 const basePath = "https://run.googleapis.com/"

 // 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"
 )

 // NewService creates a new Service.
 func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) {
 	scopesOption := option.WithScopes(
 		"https://www.googleapis.com/auth/cloud-platform",
 	)
 	// NOTE: prepend, so we don't override user-specified scopes.
 	opts = append([]option.ClientOption{scopesOption}, opts...)
 	client, endpoint, err := htransport.NewClient(ctx, opts...)
 	if err != nil {
 		return nil, err
 	}
 	s, err := New(client)
 	if err != nil {
 		return nil, err
 	}
 	if endpoint != "" {
 		s.BasePath = endpoint
 	}
 	return s, nil
 }

 // 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) {
 	if client == nil {
 		return nil, errors.New("client is nil")
 	}
 	s := &Service{client: client, BasePath: basePath}
 	s.Projects = NewProjectsService(s)
 	return s, nil
 }

 type Service struct {
 	client    *http.Client
 	BasePath  string // API endpoint base URL
 	UserAgent string // optional additional User-Agent fragment

 	Projects *ProjectsService
 }

 func (s *Service) userAgent() string {
 	if s.UserAgent == "" {
 		return googleapi.UserAgent
 	}
 	return googleapi.UserAgent + " " + s.UserAgent
 }

 func NewProjectsService(s *Service) *ProjectsService {
 	rs := &ProjectsService{s: s}
 	rs.Locations = NewProjectsLocationsService(s)
 	return rs
 }

 type ProjectsService struct {
 	s *Service

 	Locations *ProjectsLocationsService
 }

 func NewProjectsLocationsService(s *Service) *ProjectsLocationsService {
 	rs := &ProjectsLocationsService{s: s}
 	return rs
 }

 type ProjectsLocationsService struct {
 	s *Service
 }

 // ListLocationsResponse: The response message for
 // Locations.ListLocations.
 type ListLocationsResponse struct {
 	// Locations: A list of locations that matches the specified filter in
 	// the request.
 	Locations []*Location `json:"locations,omitempty"`

 	// NextPageToken: The standard List next-page token.
 	NextPageToken string `json:"nextPageToken,omitempty"`

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

 	// ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 (s *ListLocationsResponse) MarshalJSON() ([]byte, error) {
 	type NoMethod ListLocationsResponse
 	raw := NoMethod(*s)
 	return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
 }

 // Location: A resource that represents Google Cloud Platform location.
 type Location struct {
 	// DisplayName: The friendly name for this location, typically a nearby
 	// city name.
 	// For example, "Tokyo".
 	DisplayName string `json:"displayName,omitempty"`

 	// Labels: Cross-service attributes for the location. For example
 	//
 	//     {"cloud.googleapis.com/region": "us-east1"}
 	Labels map[string]string `json:"labels,omitempty"`

 	// LocationId: The canonical id for this location. For example:
 	// "us-east1".
 	LocationId string `json:"locationId,omitempty"`

 	// Metadata: Service-specific metadata. For example the available
 	// capacity at the given
 	// location.
 	Metadata googleapi.RawMessage `json:"metadata,omitempty"`

 	// Name: Resource name for the location, which may vary between
 	// implementations.
 	// For example: "projects/example-project/locations/us-east1"
 	Name string `json:"name,omitempty"`

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

 	// ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 (s *Location) MarshalJSON() ([]byte, error) {
 	type NoMethod Location
 	raw := NoMethod(*s)
 	return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
 }

 // method id "run.projects.locations.get":

 type ProjectsLocationsGetCall struct {
 	s            *Service
 	name         string
 	urlParams_   gensupport.URLParams
 	ifNoneMatch_ string
 	ctx_         context.Context
 	header_      http.Header
 }

 // Get: Gets information about a location.
 func (r *ProjectsLocationsService) Get(name string) *ProjectsLocationsGetCall {
 	c := &ProjectsLocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
 	c.name = name
 	return c
 }

 // Fields allows partial responses to be retrieved. See
 // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
 // for more information.
 func (c *ProjectsLocationsGetCall) Fields(s ...googleapi.Field) *ProjectsLocationsGetCall {
 	c.urlParams_.Set("fields", googleapi.CombineFields(s))
 	return c
 }

 // 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 (c *ProjectsLocationsGetCall) IfNoneMatch(entityTag string) *ProjectsLocationsGetCall {
 	c.ifNoneMatch_ = entityTag
 	return c
 }

 // 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 (c *ProjectsLocationsGetCall) Context(ctx context.Context) *ProjectsLocationsGetCall {
 	c.ctx_ = ctx
 	return c
 }

 // Header returns an http.Header that can be modified by the caller to
 // add HTTP headers to the request.
 func (c *ProjectsLocationsGetCall) Header() http.Header {
 	if c.header_ == nil {
 		c.header_ = make(http.Header)
 	}
 	return c.header_
 }

 func (c *ProjectsLocationsGetCall) doRequest(alt string) (*http.Response, error) {
 	reqHeaders := make(http.Header)
 	reqHeaders.Set("x-goog-api-client", "gl-go/1.11.0 gdcl/20190914")
 	for k, v := range c.header_ {
 		reqHeaders[k] = v
 	}
 	reqHeaders.Set("User-Agent", c.s.userAgent())
 	if c.ifNoneMatch_ != "" {
 		reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
 	}
 	var body io.Reader = nil
 	c.urlParams_.Set("alt", alt)
 	c.urlParams_.Set("prettyPrint", "false")
 	urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}")
 	urls += "?" + c.urlParams_.Encode()
 	req, err := http.NewRequest("GET", urls, body)
 	if err != nil {
 		return nil, err
 	}
 	req.Header = reqHeaders
 	googleapi.Expand(req.URL, map[string]string{
 		"name": c.name,
 	})
 	return gensupport.SendRequest(c.ctx_, c.s.client, req)
 }

 // Do executes the "run.projects.locations.get" call.
 // Exactly one of *Location or error will be non-nil. Any non-2xx status
 // code is an error. Response headers are in either
 // *Location.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 *ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (*Location, error) {
 	gensupport.SetOptions(c.urlParams_, opts...)
 	res, err := c.doRequest("json")
 	if res != nil && res.StatusCode == http.StatusNotModified {
 		if res.Body != nil {
 			res.Body.Close()
 		}
 		return nil, &googleapi.Error{
 			Code:   res.StatusCode,
 			Header: res.Header,
 		}
 	}
 	if err != nil {
 		return nil, err
 	}
 	defer googleapi.CloseBody(res)
 	if err := googleapi.CheckResponse(res); err != nil {
 		return nil, err
 	}
 	ret := &Location{
 		ServerResponse: googleapi.ServerResponse{
 			Header:         res.Header,
 			HTTPStatusCode: res.StatusCode,
 		},
 	}
 	target := &ret
 	if err := gensupport.DecodeResponse(target, res); err != nil {
 		return nil, err
 	}
 	return ret, nil
 	// {
 	//   "description": "Gets information about a location.",
 	//   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}",
 	//   "httpMethod": "GET",
 	//   "id": "run.projects.locations.get",
 	//   "parameterOrder": [
 	//     "name"
 	//   ],
 	//   "parameters": {
 	//     "name": {
 	//       "description": "Resource name for the location.",
 	//       "location": "path",
 	//       "pattern": "^projects/[^/]+/locations/[^/]+$",
 	//       "required": true,
 	//       "type": "string"
 	//     }
 	//   },
 	//   "path": "v1/{+name}",
 	//   "response": {
 	//     "$ref": "Location"
 	//   },
 	//   "scopes": [
 	//     "https://www.googleapis.com/auth/cloud-platform"
 	//   ]
 	// }

 }

 // method id "run.projects.locations.list":

 type ProjectsLocationsListCall struct {
 	s            *Service
 	name         string
 	urlParams_   gensupport.URLParams
 	ifNoneMatch_ string
 	ctx_         context.Context
 	header_      http.Header
 }

 // List: Lists information about the supported locations for this
 // service.
 func (r *ProjectsLocationsService) List(name string) *ProjectsLocationsListCall {
 	c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
 	c.name = name
 	return c
 }

 // Filter sets the optional parameter "filter": The standard list
 // filter.
 func (c *ProjectsLocationsListCall) Filter(filter string) *ProjectsLocationsListCall {
 	c.urlParams_.Set("filter", filter)
 	return c
 }

 // PageSize sets the optional parameter "pageSize": The standard list
 // page size.
 func (c *ProjectsLocationsListCall) PageSize(pageSize int64) *ProjectsLocationsListCall {
 	c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
 	return c
 }

 // PageToken sets the optional parameter "pageToken": The standard list
 // page token.
 func (c *ProjectsLocationsListCall) PageToken(pageToken string) *ProjectsLocationsListCall {
 	c.urlParams_.Set("pageToken", pageToken)
 	return c
 }

 // Fields allows partial responses to be retrieved. See
 // https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
 // for more information.
 func (c *ProjectsLocationsListCall) Fields(s ...googleapi.Field) *ProjectsLocationsListCall {
 	c.urlParams_.Set("fields", googleapi.CombineFields(s))
 	return c
 }

 // 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 (c *ProjectsLocationsListCall) IfNoneMatch(entityTag string) *ProjectsLocationsListCall {
 	c.ifNoneMatch_ = entityTag
 	return c
 }

 // 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 (c *ProjectsLocationsListCall) Context(ctx context.Context) *ProjectsLocationsListCall {
 	c.ctx_ = ctx
 	return c
 }

 // Header returns an http.Header that can be modified by the caller to
 // add HTTP headers to the request.
 func (c *ProjectsLocationsListCall) Header() http.Header {
 	if c.header_ == nil {
 		c.header_ = make(http.Header)
 	}
 	return c.header_
 }

 func (c *ProjectsLocationsListCall) doRequest(alt string) (*http.Response, error) {
 	reqHeaders := make(http.Header)
 	reqHeaders.Set("x-goog-api-client", "gl-go/1.11.0 gdcl/20190914")
 	for k, v := range c.header_ {
 		reqHeaders[k] = v
 	}
 	reqHeaders.Set("User-Agent", c.s.userAgent())
 	if c.ifNoneMatch_ != "" {
 		reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
 	}
 	var body io.Reader = nil
 	c.urlParams_.Set("alt", alt)
 	c.urlParams_.Set("prettyPrint", "false")
 	urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations")
 	urls += "?" + c.urlParams_.Encode()
 	req, err := http.NewRequest("GET", urls, body)
 	if err != nil {
 		return nil, err
 	}
 	req.Header = reqHeaders
 	googleapi.Expand(req.URL, map[string]string{
 		"name": c.name,
 	})
 	return gensupport.SendRequest(c.ctx_, c.s.client, req)
 }

 // Do executes the "run.projects.locations.list" call.
 // Exactly one of *ListLocationsResponse or error will be non-nil. Any
 // non-2xx status code is an error. Response headers are in either
 // *ListLocationsResponse.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 *ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (*ListLocationsResponse, error) {
 	gensupport.SetOptions(c.urlParams_, opts...)
 	res, err := c.doRequest("json")
 	if res != nil && res.StatusCode == http.StatusNotModified {
 		if res.Body != nil {
 			res.Body.Close()
 		}
 		return nil, &googleapi.Error{
 			Code:   res.StatusCode,
 			Header: res.Header,
 		}
 	}
 	if err != nil {
 		return nil, err
 	}
 	defer googleapi.CloseBody(res)
 	if err := googleapi.CheckResponse(res); err != nil {
 		return nil, err
 	}
 	ret := &ListLocationsResponse{
 		ServerResponse: googleapi.ServerResponse{
 			Header:         res.Header,
 			HTTPStatusCode: res.StatusCode,
 		},
 	}
 	target := &ret
 	if err := gensupport.DecodeResponse(target, res); err != nil {
 		return nil, err
 	}
 	return ret, nil
 	// {
 	//   "description": "Lists information about the supported locations for this service.",
 	//   "flatPath": "v1/projects/{projectsId}/locations",
 	//   "httpMethod": "GET",
 	//   "id": "run.projects.locations.list",
 	//   "parameterOrder": [
 	//     "name"
 	//   ],
 	//   "parameters": {
 	//     "filter": {
 	//       "description": "The standard list filter.",
 	//       "location": "query",
 	//       "type": "string"
 	//     },
 	//     "name": {
 	//       "description": "The resource that owns the locations collection, if applicable.",
 	//       "location": "path",
 	//       "pattern": "^projects/[^/]+$",
 	//       "required": true,
 	//       "type": "string"
 	//     },
 	//     "pageSize": {
 	//       "description": "The standard list page size.",
 	//       "format": "int32",
 	//       "location": "query",
 	//       "type": "integer"
 	//     },
 	//     "pageToken": {
 	//       "description": "The standard list page token.",
 	//       "location": "query",
 	//       "type": "string"
 	//     }
 	//   },
 	//   "path": "v1/{+name}/locations",
 	//   "response": {
 	//     "$ref": "ListLocationsResponse"
 	//   },
 	//   "scopes": [
 	//     "https://www.googleapis.com/auth/cloud-platform"
 	//   ]
 	// }

 }

 // Pages invokes f for each page of results.
 // A non-nil error returned from f will halt the iteration.
 // The provided context supersedes any context provided to the Context method.
 func (c *ProjectsLocationsListCall) Pages(ctx context.Context, f func(*ListLocationsResponse) error) error {
 	c.ctx_ = ctx
 	defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point
 	for {
 		x, err := c.Do()
 		if err != nil {
 			return err
 		}
 		if err := f(x); err != nil {
 			return err
 		}
 		if x.NextPageToken == "" {
 			return nil
 		}
 		c.PageToken(x.NextPageToken)
 	}
 }
	// Copyright 2019 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 run provides access to the Cloud Run API.
	//
	// For product documentation, see: https://cloud.google.com/run/
	//
	// Creating a client
	//
	// Usage example:
	//
	// import "google.golang.org/api/run/v1"
	// ...
	// ctx := context.Background()
	// runService, err := run.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
	//
	// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
	//
	// runService, err := run.NewService(ctx, option.WithAPIKey("AIza..."))
	//
	// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
	//
	// config := &oauth2.Config{...}
	// // ...
	// token, err := config.Exchange(ctx, ...)
	// runService, err := run.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
	//
	// See https://godoc.org/google.golang.org/api/option/ for details on options.
	package run // import "google.golang.org/api/run/v1"

	import (
	"bytes"
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"strconv"
	"strings"

	googleapi "google.golang.org/api/googleapi"
	gensupport "google.golang.org/api/internal/gensupport"
	option "google.golang.org/api/option"
	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

	const apiId = "run:v1"
	const apiName = "run"
	const apiVersion = "v1"
	const basePath = "https://run.googleapis.com/"

	// 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"
	)

	// NewService creates a new Service.
	func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) {
	scopesOption := option.WithScopes(
	"https://www.googleapis.com/auth/cloud-platform",
	)
	// NOTE: prepend, so we don't override user-specified scopes.
	opts = append([]option.ClientOption{scopesOption}, opts...)
	client, endpoint, err := htransport.NewClient(ctx, opts...)
	if err != nil {
	return nil, err
	}
	s, err := New(client)
	if err != nil {
	return nil, err
	}
	if endpoint != "" {
	s.BasePath = endpoint
	}
	return s, nil
	}

	// 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) {
	if client == nil {
	return nil, errors.New("client is nil")
	}
	s := &Service{client: client, BasePath: basePath}
	s.Projects = NewProjectsService(s)
	return s, nil
	}

	type Service struct {
	client *http.Client
	BasePath string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Projects *ProjectsService
	}

	func (s *Service) userAgent() string {
	if s.UserAgent == "" {
	return googleapi.UserAgent
	}
	return googleapi.UserAgent + " " + s.UserAgent
	}

	func NewProjectsService(s Service) ProjectsService {
	rs := &ProjectsService{s: s}
	rs.Locations = NewProjectsLocationsService(s)
	return rs
	}

	type ProjectsService struct {
	s *Service

	Locations *ProjectsLocationsService
	}

	func NewProjectsLocationsService(s Service) ProjectsLocationsService {
	rs := &ProjectsLocationsService{s: s}
	return rs
	}

	type ProjectsLocationsService struct {
	s *Service
	}

	// ListLocationsResponse: The response message for
	// Locations.ListLocations.
	type ListLocationsResponse struct {
	// Locations: A list of locations that matches the specified filter in
	// the request.
	Locations []*Location `json:"locations,omitempty"`

	// NextPageToken: The standard List next-page token.
	NextPageToken string `json:"nextPageToken,omitempty"`

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

	// ForceSendFields is a list of field names (e.g. "Locations") 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. "Locations") 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 (s *ListLocationsResponse) MarshalJSON() ([]byte, error) {
	type NoMethod ListLocationsResponse
	raw := NoMethod(*s)
	return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
	}

	// Location: A resource that represents Google Cloud Platform location.
	type Location struct {
	// DisplayName: The friendly name for this location, typically a nearby
	// city name.
	// For example, "Tokyo".
	DisplayName string `json:"displayName,omitempty"`

	// Labels: Cross-service attributes for the location. For example
	//
	// {"cloud.googleapis.com/region": "us-east1"}
	Labels map[string]string `json:"labels,omitempty"`

	// LocationId: The canonical id for this location. For example:
	// "us-east1".
	LocationId string `json:"locationId,omitempty"`

	// Metadata: Service-specific metadata. For example the available
	// capacity at the given
	// location.
	Metadata googleapi.RawMessage `json:"metadata,omitempty"`

	// Name: Resource name for the location, which may vary between
	// implementations.
	// For example: "projects/example-project/locations/us-east1"
	Name string `json:"name,omitempty"`

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

	// ForceSendFields is a list of field names (e.g. "DisplayName") 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. "DisplayName") 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 (s *Location) MarshalJSON() ([]byte, error) {
	type NoMethod Location
	raw := NoMethod(*s)
	return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields)
	}

	// method id "run.projects.locations.get":

	type ProjectsLocationsGetCall struct {
	s *Service
	name string
	urlParams_ gensupport.URLParams
	ifNoneMatch_ string
	ctx_ context.Context
	header_ http.Header
	}

	// Get: Gets information about a location.
	func (r ProjectsLocationsService) Get(name string) ProjectsLocationsGetCall {
	c := &ProjectsLocationsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)}
	c.name = name
	return c
	}

	// Fields allows partial responses to be retrieved. See
	// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
	// for more information.
	func (c ProjectsLocationsGetCall) Fields(s ...googleapi.Field) ProjectsLocationsGetCall {
	c.urlParams_.Set("fields", googleapi.CombineFields(s))
	return c
	}

	// 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 (c ProjectsLocationsGetCall) IfNoneMatch(entityTag string) ProjectsLocationsGetCall {
	c.ifNoneMatch_ = entityTag
	return c
	}

	// 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 (c ProjectsLocationsGetCall) Context(ctx context.Context) ProjectsLocationsGetCall {
	c.ctx_ = ctx
	return c
	}

	// Header returns an http.Header that can be modified by the caller to
	// add HTTP headers to the request.
	func (c *ProjectsLocationsGetCall) Header() http.Header {
	if c.header_ == nil {
	c.header_ = make(http.Header)
	}
	return c.header_
	}

	func (c ProjectsLocationsGetCall) doRequest(alt string) (http.Response, error) {
	reqHeaders := make(http.Header)
	reqHeaders.Set("x-goog-api-client", "gl-go/1.11.0 gdcl/20190914")
	for k, v := range c.header_ {
	reqHeaders[k] = v
	}
	reqHeaders.Set("User-Agent", c.s.userAgent())
	if c.ifNoneMatch_ != "" {
	reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
	}
	var body io.Reader = nil
	c.urlParams_.Set("alt", alt)
	c.urlParams_.Set("prettyPrint", "false")
	urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}")
	urls += "?" + c.urlParams_.Encode()
	req, err := http.NewRequest("GET", urls, body)
	if err != nil {
	return nil, err
	}
	req.Header = reqHeaders
	googleapi.Expand(req.URL, map[string]string{
	"name": c.name,
	})
	return gensupport.SendRequest(c.ctx_, c.s.client, req)
	}

	// Do executes the "run.projects.locations.get" call.
	// Exactly one of *Location or error will be non-nil. Any non-2xx status
	// code is an error. Response headers are in either
	// *Location.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 ProjectsLocationsGetCall) Do(opts ...googleapi.CallOption) (Location, error) {
	gensupport.SetOptions(c.urlParams_, opts...)
	res, err := c.doRequest("json")
	if res != nil && res.StatusCode == http.StatusNotModified {
	if res.Body != nil {
	res.Body.Close()
	}
	return nil, &googleapi.Error{
	Code: res.StatusCode,
	Header: res.Header,
	}
	}
	if err != nil {
	return nil, err
	}
	defer googleapi.CloseBody(res)
	if err := googleapi.CheckResponse(res); err != nil {
	return nil, err
	}
	ret := &Location{
	ServerResponse: googleapi.ServerResponse{
	Header: res.Header,
	HTTPStatusCode: res.StatusCode,
	},
	}
	target := &ret
	if err := gensupport.DecodeResponse(target, res); err != nil {
	return nil, err
	}
	return ret, nil
	// {
	// "description": "Gets information about a location.",
	// "flatPath": "v1/projects/{projectsId}/locations/{locationsId}",
	// "httpMethod": "GET",
	// "id": "run.projects.locations.get",
	// "parameterOrder": [
	// "name"
	// ],
	// "parameters": {
	// "name": {
	// "description": "Resource name for the location.",
	// "location": "path",
	// "pattern": "^projects/[^/]+/locations/[^/]+$",
	// "required": true,
	// "type": "string"
	// }
	// },
	// "path": "v1/{+name}",
	// "response": {
	// "$ref": "Location"
	// },
	// "scopes": [
	// "https://www.googleapis.com/auth/cloud-platform"
	// ]
	// }

	}

	// method id "run.projects.locations.list":

	type ProjectsLocationsListCall struct {
	s *Service
	name string
	urlParams_ gensupport.URLParams
	ifNoneMatch_ string
	ctx_ context.Context
	header_ http.Header
	}

	// List: Lists information about the supported locations for this
	// service.
	func (r ProjectsLocationsService) List(name string) ProjectsLocationsListCall {
	c := &ProjectsLocationsListCall{s: r.s, urlParams_: make(gensupport.URLParams)}
	c.name = name
	return c
	}

	// Filter sets the optional parameter "filter": The standard list
	// filter.
	func (c ProjectsLocationsListCall) Filter(filter string) ProjectsLocationsListCall {
	c.urlParams_.Set("filter", filter)
	return c
	}

	// PageSize sets the optional parameter "pageSize": The standard list
	// page size.
	func (c ProjectsLocationsListCall) PageSize(pageSize int64) ProjectsLocationsListCall {
	c.urlParams_.Set("pageSize", fmt.Sprint(pageSize))
	return c
	}

	// PageToken sets the optional parameter "pageToken": The standard list
	// page token.
	func (c ProjectsLocationsListCall) PageToken(pageToken string) ProjectsLocationsListCall {
	c.urlParams_.Set("pageToken", pageToken)
	return c
	}

	// Fields allows partial responses to be retrieved. See
	// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
	// for more information.
	func (c ProjectsLocationsListCall) Fields(s ...googleapi.Field) ProjectsLocationsListCall {
	c.urlParams_.Set("fields", googleapi.CombineFields(s))
	return c
	}

	// 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 (c ProjectsLocationsListCall) IfNoneMatch(entityTag string) ProjectsLocationsListCall {
	c.ifNoneMatch_ = entityTag
	return c
	}

	// 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 (c ProjectsLocationsListCall) Context(ctx context.Context) ProjectsLocationsListCall {
	c.ctx_ = ctx
	return c
	}

	// Header returns an http.Header that can be modified by the caller to
	// add HTTP headers to the request.
	func (c *ProjectsLocationsListCall) Header() http.Header {
	if c.header_ == nil {
	c.header_ = make(http.Header)
	}
	return c.header_
	}

	func (c ProjectsLocationsListCall) doRequest(alt string) (http.Response, error) {
	reqHeaders := make(http.Header)
	reqHeaders.Set("x-goog-api-client", "gl-go/1.11.0 gdcl/20190914")
	for k, v := range c.header_ {
	reqHeaders[k] = v
	}
	reqHeaders.Set("User-Agent", c.s.userAgent())
	if c.ifNoneMatch_ != "" {
	reqHeaders.Set("If-None-Match", c.ifNoneMatch_)
	}
	var body io.Reader = nil
	c.urlParams_.Set("alt", alt)
	c.urlParams_.Set("prettyPrint", "false")
	urls := googleapi.ResolveRelative(c.s.BasePath, "v1/{+name}/locations")
	urls += "?" + c.urlParams_.Encode()
	req, err := http.NewRequest("GET", urls, body)
	if err != nil {
	return nil, err
	}
	req.Header = reqHeaders
	googleapi.Expand(req.URL, map[string]string{
	"name": c.name,
	})
	return gensupport.SendRequest(c.ctx_, c.s.client, req)
	}

	// Do executes the "run.projects.locations.list" call.
	// Exactly one of *ListLocationsResponse or error will be non-nil. Any
	// non-2xx status code is an error. Response headers are in either
	// *ListLocationsResponse.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 ProjectsLocationsListCall) Do(opts ...googleapi.CallOption) (ListLocationsResponse, error) {
	gensupport.SetOptions(c.urlParams_, opts...)
	res, err := c.doRequest("json")
	if res != nil && res.StatusCode == http.StatusNotModified {
	if res.Body != nil {
	res.Body.Close()
	}
	return nil, &googleapi.Error{
	Code: res.StatusCode,
	Header: res.Header,
	}
	}
	if err != nil {
	return nil, err
	}
	defer googleapi.CloseBody(res)
	if err := googleapi.CheckResponse(res); err != nil {
	return nil, err
	}
	ret := &ListLocationsResponse{
	ServerResponse: googleapi.ServerResponse{
	Header: res.Header,
	HTTPStatusCode: res.StatusCode,
	},
	}
	target := &ret
	if err := gensupport.DecodeResponse(target, res); err != nil {
	return nil, err
	}
	return ret, nil
	// {
	// "description": "Lists information about the supported locations for this service.",
	// "flatPath": "v1/projects/{projectsId}/locations",
	// "httpMethod": "GET",
	// "id": "run.projects.locations.list",
	// "parameterOrder": [
	// "name"
	// ],
	// "parameters": {
	// "filter": {
	// "description": "The standard list filter.",
	// "location": "query",
	// "type": "string"
	// },
	// "name": {
	// "description": "The resource that owns the locations collection, if applicable.",
	// "location": "path",
	// "pattern": "^projects/[^/]+$",
	// "required": true,
	// "type": "string"
	// },
	// "pageSize": {
	// "description": "The standard list page size.",
	// "format": "int32",
	// "location": "query",
	// "type": "integer"
	// },
	// "pageToken": {
	// "description": "The standard list page token.",
	// "location": "query",
	// "type": "string"
	// }
	// },
	// "path": "v1/{+name}/locations",
	// "response": {
	// "$ref": "ListLocationsResponse"
	// },
	// "scopes": [
	// "https://www.googleapis.com/auth/cloud-platform"
	// ]
	// }

	}

	// Pages invokes f for each page of results.
	// A non-nil error returned from f will halt the iteration.
	// The provided context supersedes any context provided to the Context method.
	func (c ProjectsLocationsListCall) Pages(ctx context.Context, f func(ListLocationsResponse) error) error {
	c.ctx_ = ctx
	defer c.PageToken(c.urlParams_.Get("pageToken")) // reset paging to original point
	for {
	x, err := c.Do()
	if err != nil {
	return err
	}
	if err := f(x); err != nil {
	return err
	}
	if x.NextPageToken == "" {
	return nil
	}
	c.PageToken(x.NextPageToken)
	}
	}