// 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 adexchangebuyer provides access to the Ad Exchange Buyer API. // // For product documentation, see: https://developers.google.com/ad-exchange/buyer-rest // // Creating a client // // Usage example: // // import "google.golang.org/api/adexchangebuyer/v1.2" // ... // ctx := context.Background() // adexchangebuyerService, err := adexchangebuyer.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: // // adexchangebuyerService, err := adexchangebuyer.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, ...) // adexchangebuyerService, err := adexchangebuyer.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token))) // // See https://godoc.org/google.golang.org/api/option/ for details on options. package adexchangebuyer // import "google.golang.org/api/adexchangebuyer/v1.2" import ( "bytes" "context" "encoding/json" "errors" "fmt" "io" "net/http" "net/url" "strconv" "strings" gensupport "google.golang.org/api/gensupport" googleapi "google.golang.org/api/googleapi" 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 = "adexchangebuyer:v1.2" const apiName = "adexchangebuyer" const apiVersion = "v1.2" const basePath = "https://www.googleapis.com/adexchangebuyer/v1.2/" // OAuth2 scopes used by this API. const ( // Manage your Ad Exchange buyer account configuration AdexchangeBuyerScope = "https://www.googleapis.com/auth/adexchange.buyer" ) // NewService creates a new Service. func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error) { scopesOption := option.WithScopes( "https://www.googleapis.com/auth/adexchange.buyer", ) // 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.Accounts = NewAccountsService(s) s.Creatives = NewCreativesService(s) return s, nil } type Service struct { client *http.Client BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment Accounts *AccountsService Creatives *CreativesService } func (s *Service) userAgent() string { if s.UserAgent == "" { return googleapi.UserAgent } return googleapi.UserAgent + " " + s.UserAgent } func NewAccountsService(s *Service) *AccountsService { rs := &AccountsService{s: s} return rs } type AccountsService struct { s *Service } func NewCreativesService(s *Service) *CreativesService { rs := &CreativesService{s: s} return rs } type CreativesService struct { s *Service } // Account: Configuration data for an Ad Exchange buyer account. type Account struct { // BidderLocation: Your bidder locations that have distinct URLs. BidderLocation []*AccountBidderLocation `json:"bidderLocation,omitempty"` // CookieMatchingNid: The nid parameter value used in cookie match // requests. Please contact your technical account manager if you need // to change this. CookieMatchingNid string `json:"cookieMatchingNid,omitempty"` // CookieMatchingUrl: The base URL used in cookie match requests. CookieMatchingUrl string `json:"cookieMatchingUrl,omitempty"` // Id: Account id. Id int64 `json:"id,omitempty"` // Kind: Resource type. Kind string `json:"kind,omitempty"` // MaximumActiveCreatives: The maximum number of active creatives that // an account can have, where a creative is active if it was inserted or // bid with in the last 30 days. Please contact your technical account // manager if you need to change this. MaximumActiveCreatives int64 `json:"maximumActiveCreatives,omitempty"` // MaximumTotalQps: The sum of all bidderLocation.maximumQps values // cannot exceed this. Please contact your technical account manager if // you need to change this. MaximumTotalQps int64 `json:"maximumTotalQps,omitempty"` // NumberActiveCreatives: The number of creatives that this account // inserted or bid with in the last 30 days. NumberActiveCreatives int64 `json:"numberActiveCreatives,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "BidderLocation") 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. "BidderLocation") 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 *Account) MarshalJSON() ([]byte, error) { type NoMethod Account raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } type AccountBidderLocation struct { // MaximumQps: The maximum queries per second the Ad Exchange will send. MaximumQps int64 `json:"maximumQps,omitempty"` // Region: The geographical region the Ad Exchange should send requests // from. Only used by some quota systems, but always setting the value // is recommended. Allowed values: // - ASIA // - EUROPE // - US_EAST // - US_WEST Region string `json:"region,omitempty"` // Url: The URL to which the Ad Exchange will send bid requests. Url string `json:"url,omitempty"` // ForceSendFields is a list of field names (e.g. "MaximumQps") 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. "MaximumQps") 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 *AccountBidderLocation) MarshalJSON() ([]byte, error) { type NoMethod AccountBidderLocation raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // AccountsList: An account feed lists Ad Exchange buyer accounts that // the user has access to. Each entry in the feed corresponds to a // single buyer account. type AccountsList struct { // Items: A list of accounts. Items []*Account `json:"items,omitempty"` // Kind: Resource type. 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. "Items") 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. "Items") 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 *AccountsList) MarshalJSON() ([]byte, error) { type NoMethod AccountsList raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // Creative: A creative and its classification data. type Creative struct { // HTMLSnippet: The HTML snippet that displays the ad when inserted in // the web page. If set, videoURL should not be set. HTMLSnippet string `json:"HTMLSnippet,omitempty"` // AccountId: Account id. AccountId int64 `json:"accountId,omitempty"` // AdvertiserId: Detected advertiser id, if any. Read-only. This field // should not be set in requests. AdvertiserId googleapi.Int64s `json:"advertiserId,omitempty"` // AdvertiserName: The name of the company being advertised in the // creative. AdvertiserName string `json:"advertiserName,omitempty"` // AgencyId: The agency id for this creative. AgencyId int64 `json:"agencyId,omitempty,string"` // ApiUploadTimestamp: The last upload timestamp of this creative if it // was uploaded via API. Read-only. The value of this field is // generated, and will be ignored for uploads. (formatted RFC 3339 // timestamp). ApiUploadTimestamp string `json:"apiUploadTimestamp,omitempty"` // Attribute: All attributes for the ads that may be shown from this // snippet. Attribute []int64 `json:"attribute,omitempty"` // BuyerCreativeId: A buyer-specific id identifying the creative in this // ad. BuyerCreativeId string `json:"buyerCreativeId,omitempty"` // ClickThroughUrl: The set of destination urls for the snippet. ClickThroughUrl []string `json:"clickThroughUrl,omitempty"` // Corrections: Shows any corrections that were applied to this // creative. Read-only. This field should not be set in requests. Corrections []*CreativeCorrections `json:"corrections,omitempty"` // DisapprovalReasons: The reasons for disapproval, if any. Note that // not all disapproval reasons may be categorized, so it is possible for // the creative to have a status of DISAPPROVED with an empty list for // disapproval_reasons. In this case, please reach out to your TAM to // help debug the issue. Read-only. This field should not be set in // requests. DisapprovalReasons []*CreativeDisapprovalReasons `json:"disapprovalReasons,omitempty"` // FilteringReasons: The filtering reasons for the creative. Read-only. // This field should not be set in requests. FilteringReasons *CreativeFilteringReasons `json:"filteringReasons,omitempty"` // Height: Ad height. Height int64 `json:"height,omitempty"` // ImpressionTrackingUrl: The set of urls to be called to record an // impression. ImpressionTrackingUrl []string `json:"impressionTrackingUrl,omitempty"` // Kind: Resource type. Kind string `json:"kind,omitempty"` // ProductCategories: Detected product categories, if any. Read-only. // This field should not be set in requests. ProductCategories []int64 `json:"productCategories,omitempty"` // RestrictedCategories: All restricted categories for the ads that may // be shown from this snippet. RestrictedCategories []int64 `json:"restrictedCategories,omitempty"` // SensitiveCategories: Detected sensitive categories, if any. // Read-only. This field should not be set in requests. SensitiveCategories []int64 `json:"sensitiveCategories,omitempty"` // Status: Creative serving status. Read-only. This field should not be // set in requests. Status string `json:"status,omitempty"` // VendorType: All vendor types for the ads that may be shown from this // snippet. VendorType []int64 `json:"vendorType,omitempty"` // Version: The version for this creative. Read-only. This field should // not be set in requests. Version int64 `json:"version,omitempty"` // VideoURL: The url to fetch a video ad. If set, HTMLSnippet should not // be set. VideoURL string `json:"videoURL,omitempty"` // Width: Ad width. Width int64 `json:"width,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "HTMLSnippet") 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. "HTMLSnippet") 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 *Creative) MarshalJSON() ([]byte, error) { type NoMethod Creative raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } type CreativeCorrections struct { // Details: Additional details about the correction. Details []string `json:"details,omitempty"` // Reason: The type of correction that was applied to the creative. Reason string `json:"reason,omitempty"` // ForceSendFields is a list of field names (e.g. "Details") 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. "Details") 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 *CreativeCorrections) MarshalJSON() ([]byte, error) { type NoMethod CreativeCorrections raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } type CreativeDisapprovalReasons struct { // Details: Additional details about the reason for disapproval. Details []string `json:"details,omitempty"` // Reason: The categorized reason for disapproval. Reason string `json:"reason,omitempty"` // ForceSendFields is a list of field names (e.g. "Details") 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. "Details") 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 *CreativeDisapprovalReasons) MarshalJSON() ([]byte, error) { type NoMethod CreativeDisapprovalReasons raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // CreativeFilteringReasons: The filtering reasons for the creative. // Read-only. This field should not be set in requests. type CreativeFilteringReasons struct { // Date: The date in ISO 8601 format for the data. The data is collected // from 00:00:00 to 23:59:59 in PST. Date string `json:"date,omitempty"` // Reasons: The filtering reasons. Reasons []*CreativeFilteringReasonsReasons `json:"reasons,omitempty"` // ForceSendFields is a list of field names (e.g. "Date") 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. "Date") 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 *CreativeFilteringReasons) MarshalJSON() ([]byte, error) { type NoMethod CreativeFilteringReasons raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } type CreativeFilteringReasonsReasons struct { // FilteringCount: The number of times the creative was filtered for the // status. The count is aggregated across all publishers on the // exchange. FilteringCount int64 `json:"filteringCount,omitempty,string"` // FilteringStatus: The filtering status code. Please refer to the // creative-status-codes.txt file for different statuses. FilteringStatus int64 `json:"filteringStatus,omitempty"` // ForceSendFields is a list of field names (e.g. "FilteringCount") 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. "FilteringCount") 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 *CreativeFilteringReasonsReasons) MarshalJSON() ([]byte, error) { type NoMethod CreativeFilteringReasonsReasons raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // CreativesList: The creatives feed lists the active creatives for the // Ad Exchange buyer accounts that the user has access to. Each entry in // the feed corresponds to a single creative. type CreativesList struct { // Items: A list of creatives. Items []*Creative `json:"items,omitempty"` // Kind: Resource type. Kind string `json:"kind,omitempty"` // NextPageToken: Continuation token used to page through creatives. To // retrieve the next page of results, set the next request's "pageToken" // value to this. 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. "Items") 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. "Items") 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 *CreativesList) MarshalJSON() ([]byte, error) { type NoMethod CreativesList raw := NoMethod(*s) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } // method id "adexchangebuyer.accounts.get": type AccountsGetCall struct { s *Service id int64 urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // Get: Gets one account by ID. func (r *AccountsService) Get(id int64) *AccountsGetCall { c := &AccountsGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.id = id 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 *AccountsGetCall) Fields(s ...googleapi.Field) *AccountsGetCall { 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 *AccountsGetCall) IfNoneMatch(entityTag string) *AccountsGetCall { 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 *AccountsGetCall) Context(ctx context.Context) *AccountsGetCall { 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 *AccountsGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *AccountsGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) 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, "accounts/{id}") 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{ "id": strconv.FormatInt(c.id, 10), }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.accounts.get" call. // Exactly one of *Account or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *Account.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 *AccountsGetCall) Do(opts ...googleapi.CallOption) (*Account, 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 := &Account{ 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 one account by ID.", // "httpMethod": "GET", // "id": "adexchangebuyer.accounts.get", // "parameterOrder": [ // "id" // ], // "parameters": { // "id": { // "description": "The account id", // "format": "int32", // "location": "path", // "required": true, // "type": "integer" // } // }, // "path": "accounts/{id}", // "response": { // "$ref": "Account" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // method id "adexchangebuyer.accounts.list": type AccountsListCall struct { s *Service urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Retrieves the authenticated user's list of accounts. func (r *AccountsService) List() *AccountsListCall { c := &AccountsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} 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 *AccountsListCall) Fields(s ...googleapi.Field) *AccountsListCall { 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 *AccountsListCall) IfNoneMatch(entityTag string) *AccountsListCall { 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 *AccountsListCall) Context(ctx context.Context) *AccountsListCall { 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 *AccountsListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *AccountsListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) 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, "accounts") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.accounts.list" call. // Exactly one of *AccountsList or error will be non-nil. Any non-2xx // status code is an error. Response headers are in either // *AccountsList.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 *AccountsListCall) Do(opts ...googleapi.CallOption) (*AccountsList, 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 := &AccountsList{ 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": "Retrieves the authenticated user's list of accounts.", // "httpMethod": "GET", // "id": "adexchangebuyer.accounts.list", // "path": "accounts", // "response": { // "$ref": "AccountsList" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // method id "adexchangebuyer.accounts.patch": type AccountsPatchCall struct { s *Service id int64 account *Account urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Patch: Updates an existing account. This method supports patch // semantics. func (r *AccountsService) Patch(id int64, account *Account) *AccountsPatchCall { c := &AccountsPatchCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.id = id c.account = account 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 *AccountsPatchCall) Fields(s ...googleapi.Field) *AccountsPatchCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) 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 *AccountsPatchCall) Context(ctx context.Context) *AccountsPatchCall { 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 *AccountsPatchCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *AccountsPatchCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.account) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/{id}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("PATCH", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "id": strconv.FormatInt(c.id, 10), }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.accounts.patch" call. // Exactly one of *Account or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *Account.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 *AccountsPatchCall) Do(opts ...googleapi.CallOption) (*Account, 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 := &Account{ 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": "Updates an existing account. This method supports patch semantics.", // "httpMethod": "PATCH", // "id": "adexchangebuyer.accounts.patch", // "parameterOrder": [ // "id" // ], // "parameters": { // "id": { // "description": "The account id", // "format": "int32", // "location": "path", // "required": true, // "type": "integer" // } // }, // "path": "accounts/{id}", // "request": { // "$ref": "Account" // }, // "response": { // "$ref": "Account" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // method id "adexchangebuyer.accounts.update": type AccountsUpdateCall struct { s *Service id int64 account *Account urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Update: Updates an existing account. func (r *AccountsService) Update(id int64, account *Account) *AccountsUpdateCall { c := &AccountsUpdateCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.id = id c.account = account 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 *AccountsUpdateCall) Fields(s ...googleapi.Field) *AccountsUpdateCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) 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 *AccountsUpdateCall) Context(ctx context.Context) *AccountsUpdateCall { 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 *AccountsUpdateCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *AccountsUpdateCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.account) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/{id}") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("PUT", urls, body) if err != nil { return nil, err } req.Header = reqHeaders googleapi.Expand(req.URL, map[string]string{ "id": strconv.FormatInt(c.id, 10), }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.accounts.update" call. // Exactly one of *Account or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *Account.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 *AccountsUpdateCall) Do(opts ...googleapi.CallOption) (*Account, 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 := &Account{ 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": "Updates an existing account.", // "httpMethod": "PUT", // "id": "adexchangebuyer.accounts.update", // "parameterOrder": [ // "id" // ], // "parameters": { // "id": { // "description": "The account id", // "format": "int32", // "location": "path", // "required": true, // "type": "integer" // } // }, // "path": "accounts/{id}", // "request": { // "$ref": "Account" // }, // "response": { // "$ref": "Account" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // method id "adexchangebuyer.creatives.get": type CreativesGetCall struct { s *Service accountId int64 buyerCreativeId string urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // Get: Gets the status for a single creative. A creative will be // available 30-40 minutes after submission. func (r *CreativesService) Get(accountId int64, buyerCreativeId string) *CreativesGetCall { c := &CreativesGetCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.accountId = accountId c.buyerCreativeId = buyerCreativeId 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 *CreativesGetCall) Fields(s ...googleapi.Field) *CreativesGetCall { 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 *CreativesGetCall) IfNoneMatch(entityTag string) *CreativesGetCall { 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 *CreativesGetCall) Context(ctx context.Context) *CreativesGetCall { 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 *CreativesGetCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *CreativesGetCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) 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, "creatives/{accountId}/{buyerCreativeId}") 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{ "accountId": strconv.FormatInt(c.accountId, 10), "buyerCreativeId": c.buyerCreativeId, }) return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.creatives.get" call. // Exactly one of *Creative or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *Creative.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 *CreativesGetCall) Do(opts ...googleapi.CallOption) (*Creative, 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 := &Creative{ 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 the status for a single creative. A creative will be available 30-40 minutes after submission.", // "httpMethod": "GET", // "id": "adexchangebuyer.creatives.get", // "parameterOrder": [ // "accountId", // "buyerCreativeId" // ], // "parameters": { // "accountId": { // "description": "The id for the account that will serve this creative.", // "format": "int32", // "location": "path", // "required": true, // "type": "integer" // }, // "buyerCreativeId": { // "description": "The buyer-specific id for this creative.", // "location": "path", // "required": true, // "type": "string" // } // }, // "path": "creatives/{accountId}/{buyerCreativeId}", // "response": { // "$ref": "Creative" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // method id "adexchangebuyer.creatives.insert": type CreativesInsertCall struct { s *Service creative *Creative urlParams_ gensupport.URLParams ctx_ context.Context header_ http.Header } // Insert: Submit a new creative. func (r *CreativesService) Insert(creative *Creative) *CreativesInsertCall { c := &CreativesInsertCall{s: r.s, urlParams_: make(gensupport.URLParams)} c.creative = creative 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 *CreativesInsertCall) Fields(s ...googleapi.Field) *CreativesInsertCall { c.urlParams_.Set("fields", googleapi.CombineFields(s)) 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 *CreativesInsertCall) Context(ctx context.Context) *CreativesInsertCall { 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 *CreativesInsertCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *CreativesInsertCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) for k, v := range c.header_ { reqHeaders[k] = v } reqHeaders.Set("User-Agent", c.s.userAgent()) var body io.Reader = nil body, err := googleapi.WithoutDataWrapper.JSONReader(c.creative) if err != nil { return nil, err } reqHeaders.Set("Content-Type", "application/json") c.urlParams_.Set("alt", alt) c.urlParams_.Set("prettyPrint", "false") urls := googleapi.ResolveRelative(c.s.BasePath, "creatives") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("POST", urls, body) if err != nil { return nil, err } req.Header = reqHeaders return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.creatives.insert" call. // Exactly one of *Creative or error will be non-nil. Any non-2xx status // code is an error. Response headers are in either // *Creative.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 *CreativesInsertCall) Do(opts ...googleapi.CallOption) (*Creative, 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 := &Creative{ 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": "Submit a new creative.", // "httpMethod": "POST", // "id": "adexchangebuyer.creatives.insert", // "path": "creatives", // "request": { // "$ref": "Creative" // }, // "response": { // "$ref": "Creative" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // method id "adexchangebuyer.creatives.list": type CreativesListCall struct { s *Service urlParams_ gensupport.URLParams ifNoneMatch_ string ctx_ context.Context header_ http.Header } // List: Retrieves a list of the authenticated user's active creatives. // A creative will be available 30-40 minutes after submission. func (r *CreativesService) List() *CreativesListCall { c := &CreativesListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c } // MaxResults sets the optional parameter "maxResults": Maximum number // of entries returned on one result page. If not set, the default is // 100. func (c *CreativesListCall) MaxResults(maxResults int64) *CreativesListCall { c.urlParams_.Set("maxResults", fmt.Sprint(maxResults)) return c } // PageToken sets the optional parameter "pageToken": A continuation // token, used to page through ad clients. To retrieve the next page, // set this parameter to the value of "nextPageToken" from the previous // response. func (c *CreativesListCall) PageToken(pageToken string) *CreativesListCall { c.urlParams_.Set("pageToken", pageToken) return c } // StatusFilter sets the optional parameter "statusFilter": When // specified, only creatives having the given status are returned. // // Possible values: // "approved" - Creatives which have been approved. // "disapproved" - Creatives which have been disapproved. // "not_checked" - Creatives whose status is not yet checked. func (c *CreativesListCall) StatusFilter(statusFilter string) *CreativesListCall { c.urlParams_.Set("statusFilter", statusFilter) 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 *CreativesListCall) Fields(s ...googleapi.Field) *CreativesListCall { 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 *CreativesListCall) IfNoneMatch(entityTag string) *CreativesListCall { 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 *CreativesListCall) Context(ctx context.Context) *CreativesListCall { 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 *CreativesListCall) Header() http.Header { if c.header_ == nil { c.header_ = make(http.Header) } return c.header_ } func (c *CreativesListCall) doRequest(alt string) (*http.Response, error) { reqHeaders := make(http.Header) 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, "creatives") urls += "?" + c.urlParams_.Encode() req, err := http.NewRequest("GET", urls, body) if err != nil { return nil, err } req.Header = reqHeaders return gensupport.SendRequest(c.ctx_, c.s.client, req) } // Do executes the "adexchangebuyer.creatives.list" call. // Exactly one of *CreativesList or error will be non-nil. Any non-2xx // status code is an error. Response headers are in either // *CreativesList.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 *CreativesListCall) Do(opts ...googleapi.CallOption) (*CreativesList, 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 := &CreativesList{ 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": "Retrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.", // "httpMethod": "GET", // "id": "adexchangebuyer.creatives.list", // "parameters": { // "maxResults": { // "description": "Maximum number of entries returned on one result page. If not set, the default is 100. Optional.", // "format": "uint32", // "location": "query", // "maximum": "1000", // "minimum": "1", // "type": "integer" // }, // "pageToken": { // "description": "A continuation token, used to page through ad clients. To retrieve the next page, set this parameter to the value of \"nextPageToken\" from the previous response. Optional.", // "location": "query", // "type": "string" // }, // "statusFilter": { // "description": "When specified, only creatives having the given status are returned.", // "enum": [ // "approved", // "disapproved", // "not_checked" // ], // "enumDescriptions": [ // "Creatives which have been approved.", // "Creatives which have been disapproved.", // "Creatives whose status is not yet checked." // ], // "location": "query", // "type": "string" // } // }, // "path": "creatives", // "response": { // "$ref": "CreativesList" // }, // "scopes": [ // "https://www.googleapis.com/auth/adexchange.buyer" // ] // } } // 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 *CreativesListCall) Pages(ctx context.Context, f func(*CreativesList) 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) } }