| // Package adexchangebuyer provides access to the Ad Exchange Buyer API. |
| // |
| // See https://developers.google.com/ad-exchange/buyer-rest |
| // |
| // Usage example: |
| // |
| // import "google.golang.org/api/adexchangebuyer/v1.2" |
| // ... |
| // adexchangebuyerService, err := adexchangebuyer.New(oauthHttpClient) |
| package adexchangebuyer |
| |
| import ( |
| "bytes" |
| "encoding/json" |
| "errors" |
| "fmt" |
| "golang.org/x/net/context" |
| "google.golang.org/api/googleapi" |
| "io" |
| "net/http" |
| "net/url" |
| "strconv" |
| "strings" |
| ) |
| |
| // 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 _ = googleapi.Version |
| var _ = errors.New |
| var _ = strings.Replace |
| var _ = context.Background |
| |
| 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" |
| ) |
| |
| 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 |
| |
| Accounts *AccountsService |
| |
| Creatives *CreativesService |
| } |
| |
| 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 |
| } |
| |
| 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"` |
| } |
| |
| 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"` |
| } |
| |
| type AccountsList struct { |
| // Items: A list of accounts. |
| Items []*Account `json:"items,omitempty"` |
| |
| // Kind: Resource type. |
| Kind string `json:"kind,omitempty"` |
| } |
| |
| 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"` |
| |
| // 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"` |
| |
| // Height: Ad height. |
| Height int64 `json:"height,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"` |
| |
| // 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"` |
| } |
| |
| 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"` |
| } |
| |
| 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"` |
| } |
| |
| 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"` |
| } |
| |
| // method id "adexchangebuyer.accounts.get": |
| |
| type AccountsGetCall struct { |
| s *Service |
| id int64 |
| opt_ map[string]interface{} |
| } |
| |
| // Get: Gets one account by ID. |
| func (r *AccountsService) Get(id int64) *AccountsGetCall { |
| c := &AccountsGetCall{s: r.s, opt_: make(map[string]interface{})} |
| 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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *AccountsGetCall) Do() (*Account, error) { |
| var body io.Reader = nil |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/{id}") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("GET", urls, body) |
| googleapi.Expand(req.URL, map[string]string{ |
| "id": strconv.FormatInt(c.id, 10), |
| }) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *Account |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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 |
| opt_ map[string]interface{} |
| } |
| |
| // List: Retrieves the authenticated user's list of accounts. |
| func (r *AccountsService) List() *AccountsListCall { |
| c := &AccountsListCall{s: r.s, opt_: make(map[string]interface{})} |
| 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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *AccountsListCall) Do() (*AccountsList, error) { |
| var body io.Reader = nil |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "accounts") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("GET", urls, body) |
| googleapi.SetOpaque(req.URL) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *AccountsList |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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 |
| opt_ map[string]interface{} |
| } |
| |
| // Patch: Updates an existing account. This method supports patch |
| // semantics. |
| func (r *AccountsService) Patch(id int64, account *Account) *AccountsPatchCall { |
| c := &AccountsPatchCall{s: r.s, opt_: make(map[string]interface{})} |
| 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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *AccountsPatchCall) Do() (*Account, error) { |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.account) |
| if err != nil { |
| return nil, err |
| } |
| ctype := "application/json" |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/{id}") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("PATCH", urls, body) |
| googleapi.Expand(req.URL, map[string]string{ |
| "id": strconv.FormatInt(c.id, 10), |
| }) |
| req.Header.Set("Content-Type", ctype) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *Account |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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 |
| opt_ map[string]interface{} |
| } |
| |
| // Update: Updates an existing account. |
| func (r *AccountsService) Update(id int64, account *Account) *AccountsUpdateCall { |
| c := &AccountsUpdateCall{s: r.s, opt_: make(map[string]interface{})} |
| 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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *AccountsUpdateCall) Do() (*Account, error) { |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.account) |
| if err != nil { |
| return nil, err |
| } |
| ctype := "application/json" |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "accounts/{id}") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("PUT", urls, body) |
| googleapi.Expand(req.URL, map[string]string{ |
| "id": strconv.FormatInt(c.id, 10), |
| }) |
| req.Header.Set("Content-Type", ctype) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *Account |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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 |
| opt_ map[string]interface{} |
| } |
| |
| // 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, opt_: make(map[string]interface{})} |
| 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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *CreativesGetCall) Do() (*Creative, error) { |
| var body io.Reader = nil |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "creatives/{accountId}/{buyerCreativeId}") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("GET", urls, body) |
| googleapi.Expand(req.URL, map[string]string{ |
| "accountId": strconv.FormatInt(c.accountId, 10), |
| "buyerCreativeId": c.buyerCreativeId, |
| }) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *Creative |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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 |
| opt_ map[string]interface{} |
| } |
| |
| // Insert: Submit a new creative. |
| func (r *CreativesService) Insert(creative *Creative) *CreativesInsertCall { |
| c := &CreativesInsertCall{s: r.s, opt_: make(map[string]interface{})} |
| 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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *CreativesInsertCall) Do() (*Creative, error) { |
| var body io.Reader = nil |
| body, err := googleapi.WithoutDataWrapper.JSONReader(c.creative) |
| if err != nil { |
| return nil, err |
| } |
| ctype := "application/json" |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "creatives") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("POST", urls, body) |
| googleapi.SetOpaque(req.URL) |
| req.Header.Set("Content-Type", ctype) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *Creative |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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 |
| opt_ map[string]interface{} |
| } |
| |
| // 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, opt_: make(map[string]interface{})} |
| 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.opt_["maxResults"] = 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.opt_["pageToken"] = pageToken |
| return c |
| } |
| |
| // StatusFilter sets the optional parameter "statusFilter": When |
| // specified, only creatives having the given status are returned. |
| func (c *CreativesListCall) StatusFilter(statusFilter string) *CreativesListCall { |
| c.opt_["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.opt_["fields"] = googleapi.CombineFields(s) |
| return c |
| } |
| |
| func (c *CreativesListCall) Do() (*CreativesList, error) { |
| var body io.Reader = nil |
| params := make(url.Values) |
| params.Set("alt", "json") |
| if v, ok := c.opt_["maxResults"]; ok { |
| params.Set("maxResults", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["pageToken"]; ok { |
| params.Set("pageToken", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["statusFilter"]; ok { |
| params.Set("statusFilter", fmt.Sprintf("%v", v)) |
| } |
| if v, ok := c.opt_["fields"]; ok { |
| params.Set("fields", fmt.Sprintf("%v", v)) |
| } |
| urls := googleapi.ResolveRelative(c.s.BasePath, "creatives") |
| urls += "?" + params.Encode() |
| req, _ := http.NewRequest("GET", urls, body) |
| googleapi.SetOpaque(req.URL) |
| req.Header.Set("User-Agent", "google-api-go-client/0.5") |
| res, err := c.s.client.Do(req) |
| if err != nil { |
| return nil, err |
| } |
| defer googleapi.CloseBody(res) |
| if err := googleapi.CheckResponse(res); err != nil { |
| return nil, err |
| } |
| var ret *CreativesList |
| if err := json.NewDecoder(res.Body).Decode(&ret); 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" |
| // ] |
| // } |
| |
| } |