Movatterモバイル変換


[0]ホーム

URL:


realtimebidding

package
v0.257.0Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 2, 2025 License:BSD-3-ClauseImports:18Imported by:0

Details

Repository

github.com/googleapis/google-api-go-client

Links

Documentation

Overview

Package realtimebidding provides access to the Real-time Bidding API.

For product documentation, see:https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/

Library status

These client libraries are officially supported by Google. However, thislibrary is considered complete and is in maintenance mode. This meansthat we will address critical bugs and security issues but will not addany new features.

When possible, we recommend using our newer[Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go)that are still actively being worked and iterated on.

Creating a client

Usage example:

import "google.golang.org/api/realtimebidding/v1"...ctx := context.Background()realtimebiddingService, err := realtimebidding.NewService(ctx)

In this example, Google Application Default Credentials are used forauthentication. For information on how to create and obtain ApplicationDefault Credentials, seehttps://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

To use an API key for authentication (note: some APIs do not support APIkeys), usegoogle.golang.org/api/option.WithAPIKey:

realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuthflow, usegoogle.golang.org/api/option.WithTokenSource:

config := &oauth2.Config{...}// ...token, err := config.Exchange(ctx, ...)realtimebiddingService, err := realtimebidding.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

Seegoogle.golang.org/api/option.ClientOption for details on options.

Index

Constants

View Source
const (// See, create, edit, and delete your Authorized Buyers and Open Bidding// account entitiesRealtimeBiddingScope = "https://www.googleapis.com/auth/realtime-bidding")

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

typeActivatePretargetingConfigRequestadded inv0.36.0

type ActivatePretargetingConfigRequest struct {}

ActivatePretargetingConfigRequest: A request to activate a pretargetingconfiguration. Sets the configuration's state to ACTIVE.

typeAdTechnologyProviders

type AdTechnologyProviders struct {// DetectedGvlIds: The detected IAB Global Vendor List (GVL) IDs for this// creative. See the IAB Global Vendor List at//https://vendor-list.consensu.org/v2/vendor-list.json for details about the// vendors.DetectedGvlIdsgoogleapi.Int64s `json:"detectedGvlIds,omitempty"`// DetectedProviderIds: The detected Google Ad Tech Providers (ATP)// (https://support.google.com/admanager/answer/9012903) for this creative. See//https://storage.googleapis.com/adx-rtb-dictionaries/providers.csv for// mapping of provider ID to provided name, a privacy policy URL, and a list of// domains which can be attributed to the provider.DetectedProviderIdsgoogleapi.Int64s `json:"detectedProviderIds,omitempty"`// UnidentifiedProviderDomains: Domains of detected unidentified ad technology// providers (if any). You must ensure that the creatives used in bids placed// for inventory that will serve to EEA or UK users does not contain// unidentified ad technology providers. Google reserves the right to filter// non-compliant bids.UnidentifiedProviderDomains []string `json:"unidentifiedProviderDomains,omitempty"`// ForceSendFields is a list of field names (e.g. "DetectedGvlIds") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "DetectedGvlIds") to include in// API requests with the JSON null value. By default, fields with empty values// are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

AdTechnologyProviders: The list of detected Ad Technology Providers for thiscreative. Bids placed for inventory that will serve to EEA or UK users areexpected to comply with GDPR requirements. You must ensure that thecreatives used in such bids should contain only user consented ad technologyproviders as indicated in the bid request. Google reserves the right tofilter non-compliant bids. User consented ad technology providers can befound in the Google Protocol(https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto)with the `BidRequest.adslot.consented_providers_settings` field, and can befound as an OpenRTB extension(https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto)with the `BidRequest.user.ext.consented_providers_settings` and`BidRequest.user.ext.consent` fields. Seehttps://support.google.com/authorizedbuyers/answer/9789378 for additionalinformation about the Google TCF v2 integration.

func (AdTechnologyProviders)MarshalJSON

func (sAdTechnologyProviders) MarshalJSON() ([]byte,error)

typeAddTargetedAppsRequestadded inv0.36.0

type AddTargetedAppsRequest struct {// AppIds: A list of app IDs to target in the pretargeting configuration. These// values will be added to the list of targeted app IDs in// PretargetingConfig.appTargeting.mobileAppTargeting.values.AppIds []string `json:"appIds,omitempty"`// TargetingMode: Required. The targeting mode that should be applied to the// list of app IDs. If there are existing targeted app IDs, must be equal to// the existing// PretargetingConfig.appTargeting.mobileAppTargeting.targetingMode or a 400// bad request error will be returned.//// Possible values://   "TARGETING_MODE_UNSPECIFIED" - Placeholder for undefined targeting mode.//   "INCLUSIVE" - The inclusive list type. Inventory must match an item in// this list to be targeted.//   "EXCLUSIVE" - The exclusive list type. Inventory must not match any item// in this list to be targeted.TargetingModestring `json:"targetingMode,omitempty"`// ForceSendFields is a list of field names (e.g. "AppIds") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AppIds") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

AddTargetedAppsRequest: A request to start targeting the provided app IDs ina specific pretargeting configuration. The pretargeting configuration itselfspecifies how these apps are targeted. inPretargetingConfig.appTargeting.mobileAppTargeting.

func (AddTargetedAppsRequest)MarshalJSONadded inv0.36.0

func (sAddTargetedAppsRequest) MarshalJSON() ([]byte,error)

typeAddTargetedPublishersRequestadded inv0.36.0

type AddTargetedPublishersRequest struct {// PublisherIds: A list of publisher IDs to target in the pretargeting// configuration. These values will be added to the list of targeted publisher// IDs in PretargetingConfig.publisherTargeting.values. Publishers are// identified by their publisher ID from ads.txt / app-ads.txt. See//https://iabtechlab.com/ads-txt/ andhttps://iabtechlab.com/app-ads-txt/ for// more details.PublisherIds []string `json:"publisherIds,omitempty"`// TargetingMode: Required. The targeting mode that should be applied to the// list of publisher IDs. If are existing publisher IDs, must be equal to the// existing PretargetingConfig.publisherTargeting.targetingMode or a 400 bad// request error will be returned.//// Possible values://   "TARGETING_MODE_UNSPECIFIED" - Placeholder for undefined targeting mode.//   "INCLUSIVE" - The inclusive list type. Inventory must match an item in// this list to be targeted.//   "EXCLUSIVE" - The exclusive list type. Inventory must not match any item// in this list to be targeted.TargetingModestring `json:"targetingMode,omitempty"`// ForceSendFields is a list of field names (e.g. "PublisherIds") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "PublisherIds") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

AddTargetedPublishersRequest: A request to start targeting the providedpublishers in a specific pretargeting configuration. The pretargetingconfiguration itself specifies how these publishers are targeted inPretargetingConfig.publisherTargeting.

func (AddTargetedPublishersRequest)MarshalJSONadded inv0.36.0

func (sAddTargetedPublishersRequest) MarshalJSON() ([]byte,error)

typeAddTargetedSitesRequestadded inv0.36.0

type AddTargetedSitesRequest struct {// Sites: A list of site URLs to target in the pretargeting configuration.// These values will be added to the list of targeted URLs in// PretargetingConfig.webTargeting.values.Sites []string `json:"sites,omitempty"`// TargetingMode: Required. The targeting mode that should be applied to the// list of site URLs. If there are existing targeted sites, must be equal to// the existing PretargetingConfig.webTargeting.targetingMode or a 400 bad// request error will be returned.//// Possible values://   "TARGETING_MODE_UNSPECIFIED" - Placeholder for undefined targeting mode.//   "INCLUSIVE" - The inclusive list type. Inventory must match an item in// this list to be targeted.//   "EXCLUSIVE" - The exclusive list type. Inventory must not match any item// in this list to be targeted.TargetingModestring `json:"targetingMode,omitempty"`// ForceSendFields is a list of field names (e.g. "Sites") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Sites") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

AddTargetedSitesRequest: A request to start targeting the provided sites ina specific pretargeting configuration. The pretargeting configuration itselfspecifies how these sites are targeted in PretargetingConfig.webTargeting.

func (AddTargetedSitesRequest)MarshalJSONadded inv0.36.0

func (sAddTargetedSitesRequest) MarshalJSON() ([]byte,error)

typeAdvertiserAndBrand

type AdvertiserAndBrand struct {// AdvertiserId: See//https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for the// list of possible values. Can be used to filter the response of the// creatives.list method.AdvertiserIdint64 `json:"advertiserId,omitempty,string"`// AdvertiserName: Advertiser name. Can be used to filter the response of the// creatives.list method.AdvertiserNamestring `json:"advertiserName,omitempty"`// BrandId: Detected brand ID or zero if no brand has been detected. See//https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt for the list// of possible values. Can be used to filter the response of the creatives.list// method.BrandIdint64 `json:"brandId,omitempty,string"`// BrandName: Brand name. Can be used to filter the response of the// creatives.list method.BrandNamestring `json:"brandName,omitempty"`// ForceSendFields is a list of field names (e.g. "AdvertiserId") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AdvertiserId") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

AdvertiserAndBrand: Detected advertiser and brand information.

func (AdvertiserAndBrand)MarshalJSON

func (sAdvertiserAndBrand) MarshalJSON() ([]byte,error)

typeAppTargetingadded inv0.36.0

type AppTargeting struct {// MobileAppCategoryTargeting: Lists of included and excluded mobile app// categories as defined in//https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.MobileAppCategoryTargeting *NumericTargetingDimension `json:"mobileAppCategoryTargeting,omitempty"`// MobileAppTargeting: Targeted app IDs. App IDs can refer to those found in an// app store or ones that are not published in an app store. A maximum of// 30,000 app IDs can be targeted.MobileAppTargeting *StringTargetingDimension `json:"mobileAppTargeting,omitempty"`// ForceSendFields is a list of field names (e.g. "MobileAppCategoryTargeting")// to unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "MobileAppCategoryTargeting") to// include in API requests with the JSON null value. By default, fields with// empty values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

AppTargeting: A subset of app inventory to target. Bid requests that matchcriteria in at least one of the specified dimensions will be sent.

func (AppTargeting)MarshalJSONadded inv0.36.0

func (sAppTargeting) MarshalJSON() ([]byte,error)

typeBatchApprovePublisherConnectionsRequestadded inv0.79.0

type BatchApprovePublisherConnectionsRequest struct {// Names: Required. The names of the publishers with which connections will be// approved. In the pattern `bidders/{bidder}/publisherConnections/{publisher}`// where `{bidder}` is the account ID of the bidder, and `{publisher}` is the// ads.txt/app-ads.txt publisher ID.Names []string `json:"names,omitempty"`// ForceSendFields is a list of field names (e.g. "Names") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Names") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

BatchApprovePublisherConnectionsRequest: A request to approve a batch ofpublisher connections.

func (BatchApprovePublisherConnectionsRequest)MarshalJSONadded inv0.79.0

typeBatchApprovePublisherConnectionsResponseadded inv0.79.0

type BatchApprovePublisherConnectionsResponse struct {// PublisherConnections: The publisher connections that have been approved.PublisherConnections []*PublisherConnection `json:"publisherConnections,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "PublisherConnections") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "PublisherConnections") to include// in API requests with the JSON null value. By default, fields with empty// values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

BatchApprovePublisherConnectionsResponse: A response for the request toapprove a batch of publisher connections.

func (BatchApprovePublisherConnectionsResponse)MarshalJSONadded inv0.79.0

typeBatchRejectPublisherConnectionsRequestadded inv0.79.0

type BatchRejectPublisherConnectionsRequest struct {// Names: Required. The names of the publishers with whom connection will be// rejected. In the pattern `bidders/{bidder}/publisherConnections/{publisher}`// where `{bidder}` is the account ID of the bidder, and `{publisher}` is the// ads.txt/app-ads.txt publisher ID.Names []string `json:"names,omitempty"`// ForceSendFields is a list of field names (e.g. "Names") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Names") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

BatchRejectPublisherConnectionsRequest: A request to reject a batch ofpublisher connections.

func (BatchRejectPublisherConnectionsRequest)MarshalJSONadded inv0.79.0

typeBatchRejectPublisherConnectionsResponseadded inv0.79.0

type BatchRejectPublisherConnectionsResponse struct {// PublisherConnections: The publisher connections that have been rejected.PublisherConnections []*PublisherConnection `json:"publisherConnections,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "PublisherConnections") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "PublisherConnections") to include// in API requests with the JSON null value. By default, fields with empty// values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

BatchRejectPublisherConnectionsResponse: A response for the request toreject a batch of publisher connections.

func (BatchRejectPublisherConnectionsResponse)MarshalJSONadded inv0.79.0

typeBidderadded inv0.42.0

type Bidder struct {// BypassNonguaranteedDealsPretargeting: Output only. An option to bypass// pretargeting for private auctions and preferred deals. When true, bid// requests from these nonguaranteed deals will always be sent. When false, bid// requests will be subject to regular pretargeting configurations.// Programmatic Guaranteed deals will always be sent to the bidder, regardless// of the value for this option. Auction packages are not impacted by this// value and are subject to the regular pretargeting configurations.BypassNonguaranteedDealsPretargetingbool `json:"bypassNonguaranteedDealsPretargeting,omitempty"`// CookieMatchingNetworkId: Output only. The buyer's network ID used for cookie// matching. This ID corresponds to the `google_nid` parameter in the URL used// in cookie match requests. Refer to//https://developers.google.com/authorized-buyers/rtb/cookie-guide for further// information.CookieMatchingNetworkIdstring `json:"cookieMatchingNetworkId,omitempty"`// CookieMatchingUrl: Output only. The base URL used in cookie match requests.// Refer tohttps://developers.google.com/authorized-buyers/rtb/cookie-guide// for further information.CookieMatchingUrlstring `json:"cookieMatchingUrl,omitempty"`// DealsBillingId: Output only. The billing ID for the deals pretargeting// config. This billing ID is sent on the bid request for guaranteed and// nonguaranteed deals matched in pretargeting.DealsBillingIdstring `json:"dealsBillingId,omitempty"`// Name: Output only. Name of the bidder resource that must follow the pattern// `bidders/{bidderAccountId}`, where `{bidderAccountId}` is the account ID of// the bidder whose information is to be received. One can get their account ID// on the Authorized Buyers or Open Bidding UI, or by contacting their Google// account manager.Namestring `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.// "BypassNonguaranteedDealsPretargeting") to unconditionally include in API// requests. By default, fields with empty or default values are omitted from// API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g.// "BypassNonguaranteedDealsPretargeting") to include in API requests with the// JSON null value. By default, fields with empty values are omitted from API// requests. Seehttps://pkg.go.dev/google.golang.org/api#hdr-NullFields for// more details.NullFields []string `json:"-"`}

Bidder: Bidder settings.

func (Bidder)MarshalJSONadded inv0.42.0

func (sBidder) MarshalJSON() ([]byte,error)

typeBiddersCreativesListCall

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

func (*BiddersCreativesListCall)Context

Context sets the context to be used in this call's Do method.

func (*BiddersCreativesListCall)Do

Do executes the "realtimebidding.bidders.creatives.list" call.Any non-2xx status code is an error. Response headers are in either*ListCreativesResponse.ServerResponse.Header or (if a response was returnedat all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersCreativesListCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersCreativesListCall)Filter

Filter sets the optional parameter "filter": Query string to filtercreatives. If no filter is specified, all active creatives will be returned.Example: 'accountId=12345 AND (dealsStatus:DISAPPROVED ANDdisapprovalReason:UNACCEPTABLE_CONTENT) ORdeclaredAttributes:IS_COOKIE_TARGETED'

func (*BiddersCreativesListCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersCreativesListCall)IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BiddersCreativesListCall)PageSize

PageSize sets the optional parameter "pageSize": Requested page size. Theserver may return fewer creatives than requested (due to timeout constraint)even if more are available through another call. If unspecified, server willpick an appropriate default. Acceptable values are 1 to 1000, inclusive.

func (*BiddersCreativesListCall)PageToken

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. Typically, this is the value ofListCreativesResponse.nextPageToken returned from the previous call to the'ListCreatives' method. Page tokens for continued pages are valid for up tofive hours, counting from the call to 'ListCreatives' for the first page.

func (*BiddersCreativesListCall)Pages

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 (*BiddersCreativesListCall)View

View sets the optional parameter "view": Controls the amount of informationincluded in the response. By default only creativeServingDecision isincluded. To retrieve the entire creative resource (including the declaredfields and the creative content) specify the view as "FULL".

Possible values:

"CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to

SERVING_DECISION_ONLY.

"SERVING_DECISION_ONLY" - Only creativeServingDecision is included in the

response.

"FULL" - The entire creative resource (including the declared fields and

the creative content) is included in the response.

typeBiddersCreativesService

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

funcNewBiddersCreativesService

func NewBiddersCreativesService(s *Service) *BiddersCreativesService

func (*BiddersCreativesService)List

List: Lists creatives as they are at the time of the initial request. Thiscall may take multiple hours to complete. For large, paginated requests,this method returns a snapshot of creatives at the time of request for thefirst page. `lastStatusUpdate` and `creativeServingDecision` may be outdatedfor creatives on sequential pages. We recommend Google Cloud Pub/Sub(//cloud.google.com/pubsub/docs/overview) to view the latest status.

  • parent: Name of the parent buyer that owns the creatives. The pattern forthis resource is either `buyers/{buyerAccountId}` or`bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the`buyerAccountId` can be one of the following: 1. The ID of the buyer thatis accessing their own creatives. 2. The ID of the child seat buyer undera bidder account. So for listing creatives pertaining to the child seatbuyer (`456`) under bidder account (`123`), you would use the pattern:`buyers/456`. 3. The ID of the bidder itself. So for listing creativespertaining to bidder (`123`), you would use `buyers/123`. If you want toaccess all creatives pertaining to both the bidder and all of its childseat accounts, you would use `bidders/{bidderAccountId}`, for example, forall creatives pertaining to bidder (`123`), use `bidders/123`.

func (*BiddersCreativesService)Watch

func (r *BiddersCreativesService) Watch(parentstring, watchcreativesrequest *WatchCreativesRequest) *BiddersCreativesWatchCall

Watch: Watches all creatives pertaining to a bidder. It is sufficient toinvoke this endpoint once per bidder. A Pub/Sub topic will be created andnotifications will be pushed to the topic when any of the bidder's creativeschange status. All of the bidder's service accounts will have access to readfrom the topic. Subsequent invocations of this method will return theexisting Pub/Sub configuration.

  • parent: To watch all creatives pertaining to the bidder and all its childseat accounts, the bidder must follow the pattern`bidders/{bidderAccountId}`.

typeBiddersCreativesWatchCall

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

func (*BiddersCreativesWatchCall)Context

Context sets the context to be used in this call's Do method.

func (*BiddersCreativesWatchCall)Do

Do executes the "realtimebidding.bidders.creatives.watch" call.Any non-2xx status code is an error. Response headers are in either*WatchCreativesResponse.ServerResponse.Header or (if a response was returnedat all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersCreativesWatchCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersCreativesWatchCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersEndpointsGetCalladded inv0.42.0

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

func (*BiddersEndpointsGetCall)Contextadded inv0.42.0

Context sets the context to be used in this call's Do method.

func (*BiddersEndpointsGetCall)Doadded inv0.42.0

Do executes the "realtimebidding.bidders.endpoints.get" call.Any non-2xx status code is an error. Response headers are in either*Endpoint.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BiddersEndpointsGetCall)Fieldsadded inv0.42.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersEndpointsGetCall)Headeradded inv0.42.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersEndpointsGetCall)IfNoneMatchadded inv0.42.0

func (c *BiddersEndpointsGetCall) IfNoneMatch(entityTagstring) *BiddersEndpointsGetCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBiddersEndpointsListCalladded inv0.42.0

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

func (*BiddersEndpointsListCall)Contextadded inv0.42.0

Context sets the context to be used in this call's Do method.

func (*BiddersEndpointsListCall)Doadded inv0.42.0

Do executes the "realtimebidding.bidders.endpoints.list" call.Any non-2xx status code is an error. Response headers are in either*ListEndpointsResponse.ServerResponse.Header or (if a response was returnedat all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersEndpointsListCall)Fieldsadded inv0.42.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersEndpointsListCall)Headeradded inv0.42.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersEndpointsListCall)IfNoneMatchadded inv0.42.0

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BiddersEndpointsListCall)PageSizeadded inv0.42.0

PageSize sets the optional parameter "pageSize": The maximum number ofendpoints to return. If unspecified, at most 100 endpoints will be returned.The maximum value is 500; values above 500 will be coerced to 500.

func (*BiddersEndpointsListCall)PageTokenadded inv0.42.0

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. This value is received from aprevious `ListEndpoints` call in ListEndpointsResponse.nextPageToken.

func (*BiddersEndpointsListCall)Pagesadded inv0.42.0

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.

typeBiddersEndpointsPatchCalladded inv0.59.0

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

func (*BiddersEndpointsPatchCall)Contextadded inv0.59.0

Context sets the context to be used in this call's Do method.

func (*BiddersEndpointsPatchCall)Doadded inv0.59.0

Do executes the "realtimebidding.bidders.endpoints.patch" call.Any non-2xx status code is an error. Response headers are in either*Endpoint.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BiddersEndpointsPatchCall)Fieldsadded inv0.59.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersEndpointsPatchCall)Headeradded inv0.59.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersEndpointsPatchCall)UpdateMaskadded inv0.59.0

UpdateMask sets the optional parameter "updateMask": Field mask to use forpartial in-place updates.

typeBiddersEndpointsServiceadded inv0.42.0

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

funcNewBiddersEndpointsServiceadded inv0.42.0

func NewBiddersEndpointsService(s *Service) *BiddersEndpointsService

func (*BiddersEndpointsService)Getadded inv0.42.0

Get: Gets a bidder endpoint by its name.

  • name: Name of the bidder endpoint to get. Format:`bidders/{bidderAccountId}/endpoints/{endpointId}`.

func (*BiddersEndpointsService)Listadded inv0.42.0

List: Lists all the bidder's endpoints.

  • parent: Name of the bidder whose endpoints will be listed. Format:`bidders/{bidderAccountId}`.

func (*BiddersEndpointsService)Patchadded inv0.59.0

Patch: Updates a bidder's endpoint.

  • name: Output only. Name of the endpoint resource that must follow thepattern `bidders/{bidderAccountId}/endpoints/{endpointId}`, where{bidderAccountId} is the account ID of the bidder who operates thisendpoint, and {endpointId} is a unique ID assigned by the server.

typeBiddersGetCalladded inv0.42.0

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

func (*BiddersGetCall)Contextadded inv0.42.0

Context sets the context to be used in this call's Do method.

func (*BiddersGetCall)Doadded inv0.42.0

Do executes the "realtimebidding.bidders.get" call.Any non-2xx status code is an error. Response headers are in either*Bidder.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BiddersGetCall)Fieldsadded inv0.42.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersGetCall)Headeradded inv0.42.0

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

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersGetCall)IfNoneMatchadded inv0.42.0

func (c *BiddersGetCall) IfNoneMatch(entityTagstring) *BiddersGetCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBiddersListCalladded inv0.42.0

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

func (*BiddersListCall)Contextadded inv0.42.0

Context sets the context to be used in this call's Do method.

func (*BiddersListCall)Doadded inv0.42.0

Do executes the "realtimebidding.bidders.list" call.Any non-2xx status code is an error. Response headers are in either*ListBiddersResponse.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersListCall)Fieldsadded inv0.42.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersListCall)Headeradded inv0.42.0

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

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersListCall)IfNoneMatchadded inv0.42.0

func (c *BiddersListCall) IfNoneMatch(entityTagstring) *BiddersListCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BiddersListCall)PageSizeadded inv0.42.0

func (c *BiddersListCall) PageSize(pageSizeint64) *BiddersListCall

PageSize sets the optional parameter "pageSize": The maximum number ofbidders to return. If unspecified, at most 100 bidders will be returned. Themaximum value is 500; values above 500 will be coerced to 500.

func (*BiddersListCall)PageTokenadded inv0.42.0

func (c *BiddersListCall) PageToken(pageTokenstring) *BiddersListCall

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. This value is received from aprevious `ListBidders` call in ListBiddersResponse.nextPageToken.

func (*BiddersListCall)Pagesadded inv0.42.0

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.

typeBiddersPretargetingConfigsActivateCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsActivateCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsActivateCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.activate" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsActivateCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsActivateCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsAddTargetedAppsCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsAddTargetedAppsCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsAddTargetedAppsCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.addTargetedApps" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsAddTargetedAppsCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsAddTargetedAppsCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsAddTargetedPublishersCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsAddTargetedPublishersCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsAddTargetedPublishersCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.addTargetedPublishers" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsAddTargetedPublishersCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsAddTargetedPublishersCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsAddTargetedSitesCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsAddTargetedSitesCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsAddTargetedSitesCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.addTargetedSites" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsAddTargetedSitesCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsAddTargetedSitesCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsCreateCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsCreateCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsCreateCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.create" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsCreateCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsCreateCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsDeleteCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsDeleteCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsDeleteCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.delete" call.Any non-2xx status code is an error. Response headers are in either*Empty.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BiddersPretargetingConfigsDeleteCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsDeleteCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsGetCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsGetCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsGetCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.get" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsGetCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsGetCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersPretargetingConfigsGetCall)IfNoneMatchadded inv0.36.0

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBiddersPretargetingConfigsListCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsListCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsListCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.list" call.Any non-2xx status code is an error. Response headers are in either*ListPretargetingConfigsResponse.ServerResponse.Header or (if a response wasreturned at all) in error.(*googleapi.Error).Header. Usegoogleapi.IsNotModified to check whether the returned error was becausehttp.StatusNotModified was returned.

func (*BiddersPretargetingConfigsListCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsListCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersPretargetingConfigsListCall)IfNoneMatchadded inv0.36.0

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BiddersPretargetingConfigsListCall)PageSizeadded inv0.36.0

PageSize sets the optional parameter "pageSize": The maximum number ofpretargeting configurations to return. If unspecified, at most 10pretargeting configurations will be returned. The maximum value is 100;values above 100 will be coerced to 100.

func (*BiddersPretargetingConfigsListCall)PageTokenadded inv0.36.0

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. This value is received from aprevious `ListPretargetingConfigs` call inListPretargetingConfigsResponse.nextPageToken.

func (*BiddersPretargetingConfigsListCall)Pagesadded inv0.36.0

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.

typeBiddersPretargetingConfigsPatchCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsPatchCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsPatchCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.patch" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsPatchCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsPatchCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersPretargetingConfigsPatchCall)UpdateMaskadded inv0.36.0

UpdateMask sets the optional parameter "updateMask": Field mask to use forpartial in-place updates.

typeBiddersPretargetingConfigsRemoveTargetedAppsCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsRemoveTargetedAppsCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsRemoveTargetedAppsCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.removeTargetedApps" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsRemoveTargetedAppsCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsRemoveTargetedAppsCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsRemoveTargetedPublishersCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsRemoveTargetedPublishersCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsRemoveTargetedPublishersCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.removeTargetedPublishers" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsRemoveTargetedPublishersCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsRemoveTargetedPublishersCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsRemoveTargetedSitesCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsRemoveTargetedSitesCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsRemoveTargetedSitesCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.removeTargetedSites" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsRemoveTargetedSitesCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsRemoveTargetedSitesCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPretargetingConfigsServiceadded inv0.36.0

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

funcNewBiddersPretargetingConfigsServiceadded inv0.36.0

func NewBiddersPretargetingConfigsService(s *Service) *BiddersPretargetingConfigsService

func (*BiddersPretargetingConfigsService)Activateadded inv0.36.0

Activate: Activates a pretargeting configuration.

  • name: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)AddTargetedAppsadded inv0.36.0

func (r *BiddersPretargetingConfigsService) AddTargetedApps(pretargetingConfigstring, addtargetedappsrequest *AddTargetedAppsRequest) *BiddersPretargetingConfigsAddTargetedAppsCall

AddTargetedApps: Adds targeted apps to the pretargeting configuration.

  • pretargetingConfig: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)AddTargetedPublishersadded inv0.36.0

func (r *BiddersPretargetingConfigsService) AddTargetedPublishers(pretargetingConfigstring, addtargetedpublishersrequest *AddTargetedPublishersRequest) *BiddersPretargetingConfigsAddTargetedPublishersCall

AddTargetedPublishers: Adds targeted publishers to the pretargeting config.

  • pretargetingConfig: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)AddTargetedSitesadded inv0.36.0

func (r *BiddersPretargetingConfigsService) AddTargetedSites(pretargetingConfigstring, addtargetedsitesrequest *AddTargetedSitesRequest) *BiddersPretargetingConfigsAddTargetedSitesCall

AddTargetedSites: Adds targeted sites to the pretargeting configuration.

  • pretargetingConfig: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)Createadded inv0.36.0

Create: Creates a pretargeting configuration. A pretargeting configuration'sstate (PretargetingConfig.state) is active upon creation, and it will startto affect traffic shortly after. A bidder may create a maximum of 10pretargeting configurations. Attempts to exceed this maximum results in a400 bad request error.

  • parent: Name of the bidder to create the pretargeting configuration for.Format: bidders/{bidderAccountId}.

func (*BiddersPretargetingConfigsService)Deleteadded inv0.36.0

Delete: Deletes a pretargeting configuration.

  • name: The name of the pretargeting configuration to delete. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)Getadded inv0.36.0

Get: Gets a pretargeting configuration.

  • name: Name of the pretargeting configuration to get. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)Listadded inv0.36.0

List: Lists all pretargeting configurations for a single bidder.

  • parent: Name of the bidder whose pretargeting configurations will belisted. Format: bidders/{bidderAccountId}.

func (*BiddersPretargetingConfigsService)Patchadded inv0.36.0

Patch: Updates a pretargeting configuration.

  • name: Output only. Name of the pretargeting configuration that must followthe pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`.

func (*BiddersPretargetingConfigsService)RemoveTargetedAppsadded inv0.36.0

func (r *BiddersPretargetingConfigsService) RemoveTargetedApps(pretargetingConfigstring, removetargetedappsrequest *RemoveTargetedAppsRequest) *BiddersPretargetingConfigsRemoveTargetedAppsCall

RemoveTargetedApps: Removes targeted apps from the pretargetingconfiguration.

  • pretargetingConfig: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)RemoveTargetedPublishersadded inv0.36.0

func (r *BiddersPretargetingConfigsService) RemoveTargetedPublishers(pretargetingConfigstring, removetargetedpublishersrequest *RemoveTargetedPublishersRequest) *BiddersPretargetingConfigsRemoveTargetedPublishersCall

RemoveTargetedPublishers: Removes targeted publishers from the pretargetingconfig.

  • pretargetingConfig: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)RemoveTargetedSitesadded inv0.36.0

func (r *BiddersPretargetingConfigsService) RemoveTargetedSites(pretargetingConfigstring, removetargetedsitesrequest *RemoveTargetedSitesRequest) *BiddersPretargetingConfigsRemoveTargetedSitesCall

RemoveTargetedSites: Removes targeted sites from the pretargetingconfiguration.

  • pretargetingConfig: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

func (*BiddersPretargetingConfigsService)Suspendadded inv0.36.0

Suspend: Suspends a pretargeting configuration.

  • name: The name of the pretargeting configuration. Format:bidders/{bidderAccountId}/pretargetingConfig/{configId}.

typeBiddersPretargetingConfigsSuspendCalladded inv0.36.0

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

func (*BiddersPretargetingConfigsSuspendCall)Contextadded inv0.36.0

Context sets the context to be used in this call's Do method.

func (*BiddersPretargetingConfigsSuspendCall)Doadded inv0.36.0

Do executes the "realtimebidding.bidders.pretargetingConfigs.suspend" call.Any non-2xx status code is an error. Response headers are in either*PretargetingConfig.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPretargetingConfigsSuspendCall)Fieldsadded inv0.36.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPretargetingConfigsSuspendCall)Headeradded inv0.36.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPublisherConnectionsBatchApproveCalladded inv0.79.0

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

func (*BiddersPublisherConnectionsBatchApproveCall)Contextadded inv0.79.0

Context sets the context to be used in this call's Do method.

func (*BiddersPublisherConnectionsBatchApproveCall)Doadded inv0.79.0

Do executes the "realtimebidding.bidders.publisherConnections.batchApprove" call.Any non-2xx status code is an error. Response headers are in either*BatchApprovePublisherConnectionsResponse.ServerResponse.Header or (if aresponse was returned at all) in error.(*googleapi.Error).Header. Usegoogleapi.IsNotModified to check whether the returned error was becausehttp.StatusNotModified was returned.

func (*BiddersPublisherConnectionsBatchApproveCall)Fieldsadded inv0.79.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPublisherConnectionsBatchApproveCall)Headeradded inv0.79.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPublisherConnectionsBatchRejectCalladded inv0.79.0

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

func (*BiddersPublisherConnectionsBatchRejectCall)Contextadded inv0.79.0

Context sets the context to be used in this call's Do method.

func (*BiddersPublisherConnectionsBatchRejectCall)Doadded inv0.79.0

Do executes the "realtimebidding.bidders.publisherConnections.batchReject" call.Any non-2xx status code is an error. Response headers are in either*BatchRejectPublisherConnectionsResponse.ServerResponse.Header or (if aresponse was returned at all) in error.(*googleapi.Error).Header. Usegoogleapi.IsNotModified to check whether the returned error was becausehttp.StatusNotModified was returned.

func (*BiddersPublisherConnectionsBatchRejectCall)Fieldsadded inv0.79.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPublisherConnectionsBatchRejectCall)Headeradded inv0.79.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBiddersPublisherConnectionsGetCalladded inv0.79.0

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

func (*BiddersPublisherConnectionsGetCall)Contextadded inv0.79.0

Context sets the context to be used in this call's Do method.

func (*BiddersPublisherConnectionsGetCall)Doadded inv0.79.0

Do executes the "realtimebidding.bidders.publisherConnections.get" call.Any non-2xx status code is an error. Response headers are in either*PublisherConnection.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BiddersPublisherConnectionsGetCall)Fieldsadded inv0.79.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPublisherConnectionsGetCall)Headeradded inv0.79.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersPublisherConnectionsGetCall)IfNoneMatchadded inv0.79.0

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBiddersPublisherConnectionsListCalladded inv0.79.0

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

func (*BiddersPublisherConnectionsListCall)Contextadded inv0.79.0

Context sets the context to be used in this call's Do method.

func (*BiddersPublisherConnectionsListCall)Doadded inv0.79.0

Do executes the "realtimebidding.bidders.publisherConnections.list" call.Any non-2xx status code is an error. Response headers are in either*ListPublisherConnectionsResponse.ServerResponse.Header or (if a responsewas returned at all) in error.(*googleapi.Error).Header. Usegoogleapi.IsNotModified to check whether the returned error was becausehttp.StatusNotModified was returned.

func (*BiddersPublisherConnectionsListCall)Fieldsadded inv0.79.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BiddersPublisherConnectionsListCall)Filteradded inv0.79.0

Filter sets the optional parameter "filter": Query string to filterpublisher connections. Connections can be filtered by `displayName`,`publisherPlatform`, and `biddingState`. If no filter is specified, allpublisher connections will be returned. Example: 'displayName="GreatPublisher*" AND publisherPlatform=ADMOB AND biddingState != PENDING' Seehttps://google.aip.dev/160 for more information about filtering syntax.

func (*BiddersPublisherConnectionsListCall)Headeradded inv0.79.0

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BiddersPublisherConnectionsListCall)IfNoneMatchadded inv0.79.0

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BiddersPublisherConnectionsListCall)OrderByadded inv0.79.0

OrderBy sets the optional parameter "orderBy": Order specification by whichresults should be sorted. If no sort order is specified, the results will bereturned in alphabetic order based on the publisher's publisher code.Results can be sorted by `createTime`. Example: 'createTime DESC'.

func (*BiddersPublisherConnectionsListCall)PageSizeadded inv0.79.0

PageSize sets the optional parameter "pageSize": Requested page size. Theserver may return fewer results than requested (due to timeout constraint)even if more are available through another call. If unspecified, the serverwill pick an appropriate default. Acceptable values are 1 to 5000,inclusive.

func (*BiddersPublisherConnectionsListCall)PageTokenadded inv0.79.0

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. Typically, this is the value ofListPublisherConnectionsResponse.nextPageToken returned from the previouscall to the 'ListPublisherConnections' method.

func (*BiddersPublisherConnectionsListCall)Pagesadded inv0.79.0

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.

typeBiddersPublisherConnectionsServiceadded inv0.79.0

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

funcNewBiddersPublisherConnectionsServiceadded inv0.79.0

func NewBiddersPublisherConnectionsService(s *Service) *BiddersPublisherConnectionsService

func (*BiddersPublisherConnectionsService)BatchApproveadded inv0.79.0

BatchApprove: Batch approves multiple publisher connections.

  • parent: The bidder for whom publisher connections will be approved.Format: `bidders/{bidder}` where `{bidder}` is the account ID of thebidder.

func (*BiddersPublisherConnectionsService)BatchRejectadded inv0.79.0

BatchReject: Batch rejects multiple publisher connections.

  • parent: The bidder for whom publisher connections will be rejected.Format: `bidders/{bidder}` where `{bidder}` is the account ID of thebidder.

func (*BiddersPublisherConnectionsService)Getadded inv0.79.0

Get: Gets a publisher connection.

  • name: Name of the publisher whose connection information is to beretrieved. In the pattern`bidders/{bidder}/publisherConnections/{publisher}` where `{bidder}` isthe account ID of the bidder, and `{publisher}` is the ads.txt/app-ads.txtpublisher ID. See publisherConnection.name.

func (*BiddersPublisherConnectionsService)Listadded inv0.79.0

List: Lists publisher connections for a given bidder.

  • parent: Name of the bidder for which publishers have initiatedconnections. The pattern for this resource is `bidders/{bidder}` where`{bidder}` represents the account ID of the bidder.

typeBiddersService

type BiddersService struct {Creatives *BiddersCreativesServiceEndpoints *BiddersEndpointsServicePretargetingConfigs *BiddersPretargetingConfigsServicePublisherConnections *BiddersPublisherConnectionsService// contains filtered or unexported fields}

funcNewBiddersService

func NewBiddersService(s *Service) *BiddersService

func (*BiddersService)Getadded inv0.42.0

Get: Gets a bidder account by its name.

- name: Name of the bidder to get. Format: `bidders/{bidderAccountId}`.

func (*BiddersService)Listadded inv0.42.0

List: Lists all the bidder accounts that belong to the caller.

typeBuyeradded inv0.42.0

type Buyer struct {// ActiveCreativeCount: Output only. The number of creatives that this buyer// submitted through the API or bid with in the last 30 days. This is counted// against the maximum number of active creatives.ActiveCreativeCountint64 `json:"activeCreativeCount,omitempty,string"`// Bidder: Output only. The name of the bidder resource that is responsible for// receiving bidding traffic for this account. The bidder name must follow the// pattern `bidders/{bidderAccountId}`, where `{bidderAccountId}` is the// account ID of the bidder receiving traffic for this buyer.Bidderstring `json:"bidder,omitempty"`// BillingIds: Output only. A list of billing IDs associated with this account.// These IDs appear on: 1. A bid request, to signal which buyers are eligible// to bid on a given opportunity, and which pretargeting configurations were// matched for each eligible buyer. 2. The bid response, to attribute a winning// impression to a specific account for billing, reporting, policy and// publisher block enforcement.BillingIds []string `json:"billingIds,omitempty"`// DisplayName: Output only. The diplay name associated with this buyer// account, as visible to sellers.DisplayNamestring `json:"displayName,omitempty"`// MaximumActiveCreativeCount: Output only. The maximum number of active// creatives that this buyer can have.MaximumActiveCreativeCountint64 `json:"maximumActiveCreativeCount,omitempty,string"`// Name: Output only. Name of the buyer resource that must follow the pattern// `buyers/{buyerAccountId}`, where `{buyerAccountId}` is the account ID of the// buyer account whose information is to be received. One can get their account// ID on the Authorized Buyers or Open Bidding UI, or by contacting their// Google account manager.Namestring `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. "ActiveCreativeCount") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "ActiveCreativeCount") to include// in API requests with the JSON null value. By default, fields with empty// values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

Buyer: RTB Buyer account information.

func (Buyer)MarshalJSONadded inv0.42.0

func (sBuyer) MarshalJSON() ([]byte,error)

typeBuyersCreativesCreateCall

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

func (*BuyersCreativesCreateCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersCreativesCreateCall)Do

Do executes the "realtimebidding.buyers.creatives.create" call.Any non-2xx status code is an error. Response headers are in either*Creative.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersCreativesCreateCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersCreativesCreateCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBuyersCreativesGetCall

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

func (*BuyersCreativesGetCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersCreativesGetCall)Do

Do executes the "realtimebidding.buyers.creatives.get" call.Any non-2xx status code is an error. Response headers are in either*Creative.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersCreativesGetCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersCreativesGetCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersCreativesGetCall)IfNoneMatch

func (c *BuyersCreativesGetCall) IfNoneMatch(entityTagstring) *BuyersCreativesGetCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BuyersCreativesGetCall)View

View sets the optional parameter "view": Controls the amount of informationincluded in the response. By default only creativeServingDecision isincluded. To retrieve the entire creative resource (including the declaredfields and the creative content) specify the view as "FULL".

Possible values:

"CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to

SERVING_DECISION_ONLY.

"SERVING_DECISION_ONLY" - Only creativeServingDecision is included in the

response.

"FULL" - The entire creative resource (including the declared fields and

the creative content) is included in the response.

typeBuyersCreativesListCall

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

func (*BuyersCreativesListCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersCreativesListCall)Do

Do executes the "realtimebidding.buyers.creatives.list" call.Any non-2xx status code is an error. Response headers are in either*ListCreativesResponse.ServerResponse.Header or (if a response was returnedat all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BuyersCreativesListCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersCreativesListCall)Filter

Filter sets the optional parameter "filter": Query string to filtercreatives. If no filter is specified, all active creatives will be returned.Example: 'accountId=12345 AND (dealsStatus:DISAPPROVED ANDdisapprovalReason:UNACCEPTABLE_CONTENT) ORdeclaredAttributes:IS_COOKIE_TARGETED'

func (*BuyersCreativesListCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersCreativesListCall)IfNoneMatch

func (c *BuyersCreativesListCall) IfNoneMatch(entityTagstring) *BuyersCreativesListCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BuyersCreativesListCall)PageSize

PageSize sets the optional parameter "pageSize": Requested page size. Theserver may return fewer creatives than requested (due to timeout constraint)even if more are available through another call. If unspecified, server willpick an appropriate default. Acceptable values are 1 to 1000, inclusive.

func (*BuyersCreativesListCall)PageToken

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. Typically, this is the value ofListCreativesResponse.nextPageToken returned from the previous call to the'ListCreatives' method. Page tokens for continued pages are valid for up tofive hours, counting from the call to 'ListCreatives' for the first page.

func (*BuyersCreativesListCall)Pages

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 (*BuyersCreativesListCall)View

View sets the optional parameter "view": Controls the amount of informationincluded in the response. By default only creativeServingDecision isincluded. To retrieve the entire creative resource (including the declaredfields and the creative content) specify the view as "FULL".

Possible values:

"CREATIVE_VIEW_UNSPECIFIED" - Not specified, equivalent to

SERVING_DECISION_ONLY.

"SERVING_DECISION_ONLY" - Only creativeServingDecision is included in the

response.

"FULL" - The entire creative resource (including the declared fields and

the creative content) is included in the response.

typeBuyersCreativesPatchCall

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

func (*BuyersCreativesPatchCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersCreativesPatchCall)Do

Do executes the "realtimebidding.buyers.creatives.patch" call.Any non-2xx status code is an error. Response headers are in either*Creative.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersCreativesPatchCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersCreativesPatchCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersCreativesPatchCall)UpdateMask

UpdateMask sets the optional parameter "updateMask": Field mask to use forpartial in-place updates.

typeBuyersCreativesService

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

funcNewBuyersCreativesService

func NewBuyersCreativesService(s *Service) *BuyersCreativesService

func (*BuyersCreativesService)Create

Create: Creates a creative.

  • parent: The name of the parent buyer that the new creative belongs to thatmust follow the pattern `buyers/{buyerAccountId}`, where`{buyerAccountId}` represents the account ID of the buyer who owns acreative. For a bidder accessing creatives on behalf of a child seatbuyer, `{buyerAccountId}` should represent the account ID of the childseat buyer.

func (*BuyersCreativesService)Get

Get: Gets a creative.

- name: Name of the creative to retrieve. See creative.name.

func (*BuyersCreativesService)List

List: Lists creatives as they are at the time of the initial request. Thiscall may take multiple hours to complete. For large, paginated requests,this method returns a snapshot of creatives at the time of request for thefirst page. `lastStatusUpdate` and `creativeServingDecision` may be outdatedfor creatives on sequential pages. We recommend Google Cloud Pub/Sub(//cloud.google.com/pubsub/docs/overview) to view the latest status.

  • parent: Name of the parent buyer that owns the creatives. The pattern forthis resource is either `buyers/{buyerAccountId}` or`bidders/{bidderAccountId}`. For `buyers/{buyerAccountId}`, the`buyerAccountId` can be one of the following: 1. The ID of the buyer thatis accessing their own creatives. 2. The ID of the child seat buyer undera bidder account. So for listing creatives pertaining to the child seatbuyer (`456`) under bidder account (`123`), you would use the pattern:`buyers/456`. 3. The ID of the bidder itself. So for listing creativespertaining to bidder (`123`), you would use `buyers/123`. If you want toaccess all creatives pertaining to both the bidder and all of its childseat accounts, you would use `bidders/{bidderAccountId}`, for example, forall creatives pertaining to bidder (`123`), use `bidders/123`.

func (*BuyersCreativesService)Patch

Patch: Updates a creative.

  • name: Output only. Name of the creative. Follows the pattern`buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents theaccount ID of the buyer who owns the creative, and `{creative}` is thebuyer-specific creative ID that references this creative in the bidresponse.

typeBuyersGetCalladded inv0.42.0

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

func (*BuyersGetCall)Contextadded inv0.42.0

Context sets the context to be used in this call's Do method.

func (*BuyersGetCall)Doadded inv0.42.0

func (c *BuyersGetCall) Do(opts ...googleapi.CallOption) (*Buyer,error)

Do executes the "realtimebidding.buyers.get" call.Any non-2xx status code is an error. Response headers are in either*Buyer.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersGetCall)Fieldsadded inv0.42.0

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

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersGetCall)Headeradded inv0.42.0

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

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersGetCall)IfNoneMatchadded inv0.42.0

func (c *BuyersGetCall) IfNoneMatch(entityTagstring) *BuyersGetCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBuyersGetRemarketingTagCall

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

func (*BuyersGetRemarketingTagCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersGetRemarketingTagCall)Do

Do executes the "realtimebidding.buyers.getRemarketingTag" call.Any non-2xx status code is an error. Response headers are in either*GetRemarketingTagResponse.ServerResponse.Header or (if a response wasreturned at all) in error.(*googleapi.Error).Header. Usegoogleapi.IsNotModified to check whether the returned error was becausehttp.StatusNotModified was returned.

func (*BuyersGetRemarketingTagCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersGetRemarketingTagCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersGetRemarketingTagCall)IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBuyersListCalladded inv0.42.0

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

func (*BuyersListCall)Contextadded inv0.42.0

Context sets the context to be used in this call's Do method.

func (*BuyersListCall)Doadded inv0.42.0

Do executes the "realtimebidding.buyers.list" call.Any non-2xx status code is an error. Response headers are in either*ListBuyersResponse.ServerResponse.Header or (if a response was returned atall) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BuyersListCall)Fieldsadded inv0.42.0

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersListCall)Headeradded inv0.42.0

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

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersListCall)IfNoneMatchadded inv0.42.0

func (c *BuyersListCall) IfNoneMatch(entityTagstring) *BuyersListCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BuyersListCall)PageSizeadded inv0.42.0

func (c *BuyersListCall) PageSize(pageSizeint64) *BuyersListCall

PageSize sets the optional parameter "pageSize": The maximum number ofbuyers to return. If unspecified, at most 100 buyers will be returned. Themaximum value is 500; values above 500 will be coerced to 500.

func (*BuyersListCall)PageTokenadded inv0.42.0

func (c *BuyersListCall) PageToken(pageTokenstring) *BuyersListCall

PageToken sets the optional parameter "pageToken": A token identifying apage of results the server should return. This value is received from aprevious `ListBuyers` call in ListBuyersResponse.nextPageToken.

func (*BuyersListCall)Pagesadded inv0.42.0

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.

typeBuyersService

type BuyersService struct {Creatives *BuyersCreativesServiceUserLists *BuyersUserListsService// contains filtered or unexported fields}

funcNewBuyersService

func NewBuyersService(s *Service) *BuyersService

func (*BuyersService)Getadded inv0.42.0

func (r *BuyersService) Get(namestring) *BuyersGetCall

Get: Gets a buyer account by its name.

- name: Name of the buyer to get. Format: `buyers/{buyerId}`.

func (*BuyersService)GetRemarketingTag

func (r *BuyersService) GetRemarketingTag(namestring) *BuyersGetRemarketingTagCall

GetRemarketingTag: This has been sunset as of October 2023, and will returnan error response if called. For more information, see the release notes:https://developers.google.com/authorized-buyers/apis/relnotes#real-time-bidding-apiGets remarketing tag for a buyer. A remarketing tag is a piece of JavaScriptcode that can be placed on a web page. When a user visits a page containinga remarketing tag, Google adds the user to a user list.

  • name: To fetch the remarketing tag for an account, the name must followthe pattern `buyers/{accountId}`, where `{accountId}` represents the ID ofthe buyer that owns the remarketing tag. For a bidder accessing theremarketing tag on behalf of a child seat buyer, `{accountId}` shouldrepresent the ID of the child seat buyer. To fetch the remarketing tag fora specific user list, the name must follow the pattern`buyers/{accountId}/userLists/{userListId}`. See UserList.name.

func (*BuyersService)Listadded inv0.42.0

func (r *BuyersService) List() *BuyersListCall

List: Lists all buyer account information the calling buyer user or serviceaccount is permissioned to manage.

typeBuyersUserListsCloseCall

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

func (*BuyersUserListsCloseCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsCloseCall)Do

Do executes the "realtimebidding.buyers.userLists.close" call.Any non-2xx status code is an error. Response headers are in either*UserList.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersUserListsCloseCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsCloseCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBuyersUserListsCreateCall

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

func (*BuyersUserListsCreateCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsCreateCall)Do

Do executes the "realtimebidding.buyers.userLists.create" call.Any non-2xx status code is an error. Response headers are in either*UserList.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersUserListsCreateCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsCreateCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBuyersUserListsGetCall

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

func (*BuyersUserListsGetCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsGetCall)Do

Do executes the "realtimebidding.buyers.userLists.get" call.Any non-2xx status code is an error. Response headers are in either*UserList.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersUserListsGetCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsGetCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersUserListsGetCall)IfNoneMatch

func (c *BuyersUserListsGetCall) IfNoneMatch(entityTagstring) *BuyersUserListsGetCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBuyersUserListsGetRemarketingTagCall

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

func (*BuyersUserListsGetRemarketingTagCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsGetRemarketingTagCall)Do

Do executes the "realtimebidding.buyers.userLists.getRemarketingTag" call.Any non-2xx status code is an error. Response headers are in either*GetRemarketingTagResponse.ServerResponse.Header or (if a response wasreturned at all) in error.(*googleapi.Error).Header. Usegoogleapi.IsNotModified to check whether the returned error was becausehttp.StatusNotModified was returned.

func (*BuyersUserListsGetRemarketingTagCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsGetRemarketingTagCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersUserListsGetRemarketingTagCall)IfNoneMatch

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

typeBuyersUserListsListCall

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

func (*BuyersUserListsListCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsListCall)Do

Do executes the "realtimebidding.buyers.userLists.list" call.Any non-2xx status code is an error. Response headers are in either*ListUserListsResponse.ServerResponse.Header or (if a response was returnedat all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified tocheck whether the returned error was because http.StatusNotModified wasreturned.

func (*BuyersUserListsListCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsListCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

func (*BuyersUserListsListCall)IfNoneMatch

func (c *BuyersUserListsListCall) IfNoneMatch(entityTagstring) *BuyersUserListsListCall

IfNoneMatch sets an optional parameter which makes the operation fail if theobject's ETag matches the given value. This is useful for getting updatesonly after the object has changed since the last request.

func (*BuyersUserListsListCall)PageSize

PageSize sets the optional parameter "pageSize": The number of results toreturn per page.

func (*BuyersUserListsListCall)PageToken

PageToken sets the optional parameter "pageToken": Continuation page tokenas received from a previous response.

func (*BuyersUserListsListCall)Pages

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.

typeBuyersUserListsOpenCall

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

func (*BuyersUserListsOpenCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsOpenCall)Do

Do executes the "realtimebidding.buyers.userLists.open" call.Any non-2xx status code is an error. Response headers are in either*UserList.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersUserListsOpenCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsOpenCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeBuyersUserListsService

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

funcNewBuyersUserListsService

func NewBuyersUserListsService(s *Service) *BuyersUserListsService

func (*BuyersUserListsService)Close

func (r *BuyersUserListsService) Close(namestring, closeuserlistrequest *CloseUserListRequest) *BuyersUserListsCloseCall

Close: Changes the status of a user list to CLOSED. This prevents new usersfrom being added to the user list.

- name: The name of the user list to close. See UserList.name.

func (*BuyersUserListsService)Create

Create: Creates a new user list.

  • parent: The name of the parent buyer of the user list to be retrieved,which must follow the pattern `buyers/{buyerAccountId}`, where`{buyerAccountId}` represents the account ID of the buyer who owns theuser list. For a bidder accessing user lists on behalf of a child seatbuyer, `{buyerAccountId}` should represent the account ID of the childseat buyer.

func (*BuyersUserListsService)Get

Get: Gets a user list by its name.

- name: The name of the user list to be retrieved. See UserList.name.

func (*BuyersUserListsService)GetRemarketingTag

GetRemarketingTag: This has been sunset as of October 2023, and will returnan error response if called. For more information, see the release notes:https://developers.google.com/authorized-buyers/apis/relnotes#real-time-bidding-apiGets remarketing tag for a buyer. A remarketing tag is a piece of JavaScriptcode that can be placed on a web page. When a user visits a page containinga remarketing tag, Google adds the user to a user list.

  • name: To fetch the remarketing tag for an account, the name must followthe pattern `buyers/{accountId}`, where `{accountId}` represents the ID ofthe buyer that owns the remarketing tag. For a bidder accessing theremarketing tag on behalf of a child seat buyer, `{accountId}` shouldrepresent the ID of the child seat buyer. To fetch the remarketing tag fora specific user list, the name must follow the pattern`buyers/{accountId}/userLists/{userListId}`. See UserList.name.

func (*BuyersUserListsService)List

List: Lists the user lists visible to the current user.

  • parent: The name of the parent buyer for the user lists to be returnedthat must follow the pattern `buyers/{buyerAccountId}`, where`{buyerAccountId}` represents the account ID of the buyer who owns userlists. For a bidder accessing user lists on behalf of a child seat buyer ,`{buyerAccountId}` should represent the account ID of the child seatbuyer.

func (*BuyersUserListsService)Open

Open: Changes the status of a user list to OPEN. This allows new users to beadded to the user list.

- name: The name of the user list to open. See UserList.name.

func (*BuyersUserListsService)Update

Update: Updates the given user list. Only user lists with URLRestrictionscan be updated.

  • name: Output only. Name of the user list that must follow the pattern`buyers/{buyer}/userLists/{user_list}`, where `{buyer}` represents theaccount ID of the buyer who owns the user list. For a bidder accessinguser lists on behalf of a child seat buyer, `{buyer}` represents theaccount ID of the child seat buyer. `{user_list}` is an int64 identifierassigned by Google to uniquely identify a user list.

typeBuyersUserListsUpdateCall

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

func (*BuyersUserListsUpdateCall)Context

Context sets the context to be used in this call's Do method.

func (*BuyersUserListsUpdateCall)Do

Do executes the "realtimebidding.buyers.userLists.update" call.Any non-2xx status code is an error. Response headers are in either*UserList.ServerResponse.Header or (if a response was returned at all) inerror.(*googleapi.Error).Header. Use googleapi.IsNotModified to checkwhether the returned error was because http.StatusNotModified was returned.

func (*BuyersUserListsUpdateCall)Fields

Fields allows partial responses to be retrieved. Seehttps://developers.google.com/gdata/docs/2.0/basics#PartialResponse for moredetails.

func (*BuyersUserListsUpdateCall)Header

Header returns a http.Header that can be modified by the caller to addheaders to the request.

typeCloseUserListRequest

type CloseUserListRequest struct {}

CloseUserListRequest: A request to close a specified user list.

typeCreative

type Creative struct {// AccountId: Output only. ID of the buyer account that this creative is owned// by. Can be used to filter the response of the creatives.list method with// equality and inequality check.AccountIdint64 `json:"accountId,omitempty,string"`// AdChoicesDestinationUrl: The link to AdChoices destination page. This is// only supported for native ads.AdChoicesDestinationUrlstring `json:"adChoicesDestinationUrl,omitempty"`// AdvertiserName: The name of the company being advertised in the creative.// Can be used to filter the response of the creatives.list method.AdvertiserNamestring `json:"advertiserName,omitempty"`// AgencyId: The agency ID for this creative.AgencyIdint64 `json:"agencyId,omitempty,string"`// ApiUpdateTime: Output only. The last update timestamp of the creative// through the API.ApiUpdateTimestring `json:"apiUpdateTime,omitempty"`// CreativeFormat: Output only. The format of this creative. Can be used to// filter the response of the creatives.list method.//// Possible values://   "CREATIVE_FORMAT_UNSPECIFIED" - The format is unknown.//   "HTML" - HTML creative.//   "VIDEO" - Video creative.//   "NATIVE" - Native creative.CreativeFormatstring `json:"creativeFormat,omitempty"`// CreativeId: Buyer-specific creative ID that references this creative in bid// responses. This field is Ignored in update operations. Can be used to filter// the response of the creatives.list method. The maximum length of the// creative ID is 128 bytes.CreativeIdstring `json:"creativeId,omitempty"`// CreativeServingDecision: Output only. Top level status and detected// attributes of a creative (for example domain, language, advertiser, product// category, etc.) that affect whether (status) and where (context) a creative// will be allowed to serve.CreativeServingDecision *CreativeServingDecision `json:"creativeServingDecision,omitempty"`// DealIds: Output only. IDs of all of the deals with which this creative has// been used in bidding. Can be used to filter the response of the// creatives.list method.DealIds []string `json:"dealIds,omitempty"`// DeclaredAttributes: All declared attributes for the ads that may be shown// from this creative. Can be used to filter the response of the creatives.list// method. If the `excluded_attribute` field of a bid request// (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto")// contains one of the attributes that were declared or detected for a given// creative, and a bid is submitted with that creative, the bid will be// filtered before the auction.//// Possible values://   "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value only.//   "IMAGE_RICH_MEDIA" - The creative is of type image/rich media. For// pretargeting.//   "ADOBE_FLASH_FLV" - The creative is of video type Adobe Flash FLV. For// pretargeting.//   "IS_TAGGED" - The creative is tagged.//   "IS_COOKIE_TARGETED" - The creative is cookie targeted.//   "IS_USER_INTEREST_TARGETED" - The creative is user interest targeted.//   "EXPANDING_DIRECTION_NONE" - The creative does not expand.//   "EXPANDING_DIRECTION_UP" - The creative expands up.//   "EXPANDING_DIRECTION_DOWN" - The creative expands down.//   "EXPANDING_DIRECTION_LEFT" - The creative expands left.//   "EXPANDING_DIRECTION_RIGHT" - The creative expands right.//   "EXPANDING_DIRECTION_UP_LEFT" - The creative expands up and left.//   "EXPANDING_DIRECTION_UP_RIGHT" - The creative expands up and right.//   "EXPANDING_DIRECTION_DOWN_LEFT" - The creative expands down and left.//   "EXPANDING_DIRECTION_DOWN_RIGHT" - The creative expands down and right.//   "CREATIVE_TYPE_HTML" - The creative type is HTML.//   "CREATIVE_TYPE_VAST_VIDEO" - The creative type is VAST video.//   "EXPANDING_DIRECTION_UP_OR_DOWN" - The creative expands up or down.//   "EXPANDING_DIRECTION_LEFT_OR_RIGHT" - The creative expands left or right.//   "EXPANDING_DIRECTION_ANY_DIAGONAL" - The creative expands on any diagonal.//   "EXPANDING_ACTION_ROLLOVER_TO_EXPAND" - The creative expands when rolled// over.//   "INSTREAM_VAST_VIDEO_TYPE_VPAID_FLASH" - The instream vast video type is// vpaid flash.//   "RICH_MEDIA_CAPABILITY_TYPE_MRAID" - The creative is MRAID.//   "RICH_MEDIA_CAPABILITY_TYPE_FLASH" - The creative is Flash.//   "RICH_MEDIA_CAPABILITY_TYPE_HTML5" - The creative is HTML5.//   "SKIPPABLE_INSTREAM_VIDEO" - The creative has an instream VAST video type// of skippable instream video. For pretargeting.//   "RICH_MEDIA_CAPABILITY_TYPE_SSL" - The creative is SSL.//   "RICH_MEDIA_CAPABILITY_TYPE_NON_SSL" - The creative is non-SSL.//   "RICH_MEDIA_CAPABILITY_TYPE_INTERSTITIAL" - The creative is an// interstitial.//   "NON_SKIPPABLE_INSTREAM_VIDEO" - The creative has an instream VAST video// type of non-skippable instream video. For pretargeting.//   "NATIVE_ELIGIBILITY_ELIGIBLE" - The creative is eligible for native.//   "NON_VPAID" - The creative has an instream VAST video type of non-VPAID.// For pretargeting.//   "NATIVE_ELIGIBILITY_NOT_ELIGIBLE" - The creative is not eligible for// native.//   "ANY_INTERSTITIAL" - The creative has an interstitial size of any// interstitial. For pretargeting.//   "NON_INTERSTITIAL" - The creative has an interstitial size of non// interstitial. For pretargeting.//   "IN_BANNER_VIDEO" - The video type is in-banner video.//   "RENDERING_SIZELESS_ADX" - The creative can dynamically resize to fill a// variety of slot sizes.//   "OMSDK_1_0" - The open measurement SDK is supported.//   "RENDERING_PLAYABLE" - The creative is considered a playable display// creative.DeclaredAttributes []string `json:"declaredAttributes,omitempty"`// DeclaredClickThroughUrls: The set of declared destination URLs for the// creative. Can be used to filter the response of the creatives.list method.DeclaredClickThroughUrls []string `json:"declaredClickThroughUrls,omitempty"`// DeclaredRestrictedCategories: All declared restricted categories for the ads// that may be shown from this creative. Can be used to filter the response of// the creatives.list method.//// Possible values://   "RESTRICTED_CATEGORY_UNSPECIFIED" - Default value that should never be// used.//   "ALCOHOL" - The alcohol restricted category.DeclaredRestrictedCategories []string `json:"declaredRestrictedCategories,omitempty"`// DeclaredVendorIds: IDs for the declared ad technology vendors that may be// used by this creative. See//https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible// values. Can be used to filter the response of the creatives.list method.DeclaredVendorIds []int64 `json:"declaredVendorIds,omitempty"`// Html: An HTML creative.Html *HtmlContent `json:"html,omitempty"`// ImpressionTrackingUrls: The set of URLs to be called to record an// impression.ImpressionTrackingUrls []string `json:"impressionTrackingUrls,omitempty"`// Name: Output only. Name of the creative. Follows the pattern// `buyers/{buyer}/creatives/{creative}`, where `{buyer}` represents the// account ID of the buyer who owns the creative, and `{creative}` is the// buyer-specific creative ID that references this creative in the bid// response.Namestring `json:"name,omitempty"`// Native: A native creative.Native *NativeContent `json:"native,omitempty"`// RenderUrl: Experimental field that can be used during the FLEDGE Origin// Trial (/authorized-buyers/rtb/fledge-origin-trial). The URL to fetch an// interest group ad used in TURTLEDOVE on-device auction// (https://github.com/WICG/turtledove/blob/main/FLEDGE.md#1-browsers-record-interest-groups").// This should be unique among all creatives for a given `accountId`. This URL// should be the same as the URL returned by generateBid()// (https://github.com/WICG/turtledove/blob/main/FLEDGE.md#32-on-device-bidding).RenderUrlstring `json:"renderUrl,omitempty"`// RestrictedCategories: All restricted categories for the ads that may be// shown from this creative.//// Possible values://   "RESTRICTED_CATEGORY_UNSPECIFIED" - Default value that should never be// used.//   "ALCOHOL" - The alcohol restricted category.RestrictedCategories []string `json:"restrictedCategories,omitempty"`// Version: Output only. The version of the creative. Version for a new// creative is 1 and it increments during subsequent creative updates.Versionint64 `json:"version,omitempty"`// Video: A video creative.Video *VideoContent `json:"video,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "AccountId") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AccountId") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

Creative: A creative and its classification data.

func (Creative)MarshalJSON

func (sCreative) MarshalJSON() ([]byte,error)

typeCreativeDimensionsadded inv0.36.0

type CreativeDimensions struct {// Height: The height of the creative in pixels.Heightint64 `json:"height,omitempty,string"`// Width: The width of the creative in pixels.Widthint64 `json:"width,omitempty,string"`// ForceSendFields is a list of field names (e.g. "Height") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Height") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

CreativeDimensions: The dimensions of a creative. This applies to only HTMLand Native creatives.

func (CreativeDimensions)MarshalJSONadded inv0.36.0

func (sCreativeDimensions) MarshalJSON() ([]byte,error)

typeCreativeServingDecision

type CreativeServingDecision struct {// AdTechnologyProviders: The detected ad technology providers.AdTechnologyProviders *AdTechnologyProviders `json:"adTechnologyProviders,omitempty"`// ChinaPolicyCompliance: The policy compliance of this creative in China. When// approved or disapproved, this applies to both deals and open auction in// China. When pending review, this creative is allowed to serve for deals but// not for open auction.ChinaPolicyCompliance *PolicyCompliance `json:"chinaPolicyCompliance,omitempty"`// DealsPolicyCompliance: Policy compliance of this creative when bidding on// Programmatic Guaranteed and Preferred Deals (outside of Russia and China).DealsPolicyCompliance *PolicyCompliance `json:"dealsPolicyCompliance,omitempty"`// DetectedAdvertisers: Detected advertisers and brands.DetectedAdvertisers []*AdvertiserAndBrand `json:"detectedAdvertisers,omitempty"`// DetectedAttributes: Publisher-excludable attributes that were detected for// this creative. Can be used to filter the response of the creatives.list// method. If the `excluded_attribute` field of a bid request// (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto)// contains one of the attributes that were declared or detected for a given// creative, and a bid is submitted with that creative, the bid will be// filtered before the auction.//// Possible values://   "ATTRIBUTE_UNSPECIFIED" - Do not use. This is a placeholder value only.//   "IMAGE_RICH_MEDIA" - The creative is of type image/rich media. For// pretargeting.//   "ADOBE_FLASH_FLV" - The creative is of video type Adobe Flash FLV. For// pretargeting.//   "IS_TAGGED" - The creative is tagged.//   "IS_COOKIE_TARGETED" - The creative is cookie targeted.//   "IS_USER_INTEREST_TARGETED" - The creative is user interest targeted.//   "EXPANDING_DIRECTION_NONE" - The creative does not expand.//   "EXPANDING_DIRECTION_UP" - The creative expands up.//   "EXPANDING_DIRECTION_DOWN" - The creative expands down.//   "EXPANDING_DIRECTION_LEFT" - The creative expands left.//   "EXPANDING_DIRECTION_RIGHT" - The creative expands right.//   "EXPANDING_DIRECTION_UP_LEFT" - The creative expands up and left.//   "EXPANDING_DIRECTION_UP_RIGHT" - The creative expands up and right.//   "EXPANDING_DIRECTION_DOWN_LEFT" - The creative expands down and left.//   "EXPANDING_DIRECTION_DOWN_RIGHT" - The creative expands down and right.//   "CREATIVE_TYPE_HTML" - The creative type is HTML.//   "CREATIVE_TYPE_VAST_VIDEO" - The creative type is VAST video.//   "EXPANDING_DIRECTION_UP_OR_DOWN" - The creative expands up or down.//   "EXPANDING_DIRECTION_LEFT_OR_RIGHT" - The creative expands left or right.//   "EXPANDING_DIRECTION_ANY_DIAGONAL" - The creative expands on any diagonal.//   "EXPANDING_ACTION_ROLLOVER_TO_EXPAND" - The creative expands when rolled// over.//   "INSTREAM_VAST_VIDEO_TYPE_VPAID_FLASH" - The instream vast video type is// vpaid flash.//   "RICH_MEDIA_CAPABILITY_TYPE_MRAID" - The creative is MRAID.//   "RICH_MEDIA_CAPABILITY_TYPE_FLASH" - The creative is Flash.//   "RICH_MEDIA_CAPABILITY_TYPE_HTML5" - The creative is HTML5.//   "SKIPPABLE_INSTREAM_VIDEO" - The creative has an instream VAST video type// of skippable instream video. For pretargeting.//   "RICH_MEDIA_CAPABILITY_TYPE_SSL" - The creative is SSL.//   "RICH_MEDIA_CAPABILITY_TYPE_NON_SSL" - The creative is non-SSL.//   "RICH_MEDIA_CAPABILITY_TYPE_INTERSTITIAL" - The creative is an// interstitial.//   "NON_SKIPPABLE_INSTREAM_VIDEO" - The creative has an instream VAST video// type of non-skippable instream video. For pretargeting.//   "NATIVE_ELIGIBILITY_ELIGIBLE" - The creative is eligible for native.//   "NON_VPAID" - The creative has an instream VAST video type of non-VPAID.// For pretargeting.//   "NATIVE_ELIGIBILITY_NOT_ELIGIBLE" - The creative is not eligible for// native.//   "ANY_INTERSTITIAL" - The creative has an interstitial size of any// interstitial. For pretargeting.//   "NON_INTERSTITIAL" - The creative has an interstitial size of non// interstitial. For pretargeting.//   "IN_BANNER_VIDEO" - The video type is in-banner video.//   "RENDERING_SIZELESS_ADX" - The creative can dynamically resize to fill a// variety of slot sizes.//   "OMSDK_1_0" - The open measurement SDK is supported.//   "RENDERING_PLAYABLE" - The creative is considered a playable display// creative.DetectedAttributes []string `json:"detectedAttributes,omitempty"`// DetectedCategories: Output only. IDs of the detected categories. The// taxonomy in which the categories are expressed is specified by the// detected_categories_taxonomy field. Use this in conjunction with// BidRequest.bcat to avoid bidding on impressions where a given ad category is// blocked, or to troubleshoot filtered bids. Can be used to filter the// response of the creatives.list method.DetectedCategories []string `json:"detectedCategories,omitempty"`// DetectedCategoriesTaxonomy: Output only. The taxonomy in which the// detected_categories field is expressed.//// Possible values://   "AD_CATEGORY_TAXONOMY_UNSPECIFIED" - Default value that should never be// used.//   "GOOGLE_AD_CATEGORY_TAXONOMY" - Google ad categories taxonomy, including// product categories and sensitive categories. Find the category lists at//https://developers.google.com/authorized-buyers/rtb/data#reference-data//   "IAB_CONTENT_1_0" - IAB Content Taxonomy 1.0. See//https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%201.0.tsv// for more details.DetectedCategoriesTaxonomystring `json:"detectedCategoriesTaxonomy,omitempty"`// DetectedClickThroughUrls: The set of detected destination URLs for the// creative. Can be used to filter the response of the creatives.list method.DetectedClickThroughUrls []string `json:"detectedClickThroughUrls,omitempty"`// DetectedDomains: The detected domains for this creative.DetectedDomains []string `json:"detectedDomains,omitempty"`// DetectedLanguages: The detected languages for this creative. The order is// arbitrary. The codes are 2 or 5 characters and are documented at//https://developers.google.com/adwords/api/docs/appendix/languagecodes. Can// be used to filter the response of the creatives.list method.DetectedLanguages []string `json:"detectedLanguages,omitempty"`// DetectedProductCategories: Detected product categories, if any. See the// ad-product-categories.txt file in the technical documentation for a list of// IDs. Can be used to filter the response of the creatives.list method.DetectedProductCategories []int64 `json:"detectedProductCategories,omitempty"`// DetectedSensitiveCategories: Detected sensitive categories, if any. Can be// used to filter the response of the creatives.list method. See the// ad-sensitive-categories.txt file in the technical documentation for a list// of IDs. You should use these IDs along with the excluded-sensitive-category// field in the bid request to filter your bids.DetectedSensitiveCategories []int64 `json:"detectedSensitiveCategories,omitempty"`// DetectedVendorIds: IDs of the ad technology vendors that were detected to be// used by this creative. See//https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for possible// values. Can be used to filter the response of the creatives.list method. If// the `allowed_vendor_type` field of a bid request// (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto)// does not contain one of the vendor type IDs that were declared or detected// for a given creative, and a bid is submitted with that creative, the bid// will be filtered before the auction.DetectedVendorIds []int64 `json:"detectedVendorIds,omitempty"`// LastStatusUpdate: The last time the creative status was updated. Can be used// to filter the response of the creatives.list method.LastStatusUpdatestring `json:"lastStatusUpdate,omitempty"`// NetworkPolicyCompliance: Policy compliance of this creative when bidding in// open auction, private auction, or auction packages (outside of Russia and// China).NetworkPolicyCompliance *PolicyCompliance `json:"networkPolicyCompliance,omitempty"`// PlatformPolicyCompliance: Policy compliance of this creative when bidding in// Open Bidding (outside of Russia and China). For the list of platform// policies, see:https://support.google.com/platformspolicy/answer/3013851.PlatformPolicyCompliance *PolicyCompliance `json:"platformPolicyCompliance,omitempty"`// RussiaPolicyCompliance: The policy compliance of this creative in Russia.// When approved or disapproved, this applies to both deals and open auction in// Russia. When pending review, this creative is allowed to serve for deals but// not for open auction.RussiaPolicyCompliance *PolicyCompliance `json:"russiaPolicyCompliance,omitempty"`// ForceSendFields is a list of field names (e.g. "AdTechnologyProviders") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AdTechnologyProviders") to// include in API requests with the JSON null value. By default, fields with// empty values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

CreativeServingDecision: Top level status and detected attributes of acreative.

func (CreativeServingDecision)MarshalJSON

func (sCreativeServingDecision) MarshalJSON() ([]byte,error)

typeDate

type Date struct {// Day: Day of a month. Must be from 1 to 31 and valid for the year and month,// or 0 to specify a year by itself or a year and month where the day isn't// significant.Dayint64 `json:"day,omitempty"`// Month: Month of a year. Must be from 1 to 12, or 0 to specify a year without// a month and day.Monthint64 `json:"month,omitempty"`// Year: Year of the date. Must be from 1 to 9999, or 0 to specify a date// without a year.Yearint64 `json:"year,omitempty"`// ForceSendFields is a list of field names (e.g. "Day") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Day") to include in API requests// with the JSON null value. By default, fields with empty values are omitted// from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

Date: Represents a whole or partial calendar date, such as a birthday. Thetime of day and time zone are either specified elsewhere or areinsignificant. The date is relative to the Gregorian Calendar. This canrepresent one of the following: * A full date, with non-zero year, month,and day values. * A month and day, with a zero year (for example, ananniversary). * A year on its own, with a zero month and a zero day. * Ayear and month, with a zero day (for example, a credit card expirationdate). Related types: * google.type.TimeOfDay * google.type.DateTime *google.protobuf.Timestamp

func (Date)MarshalJSON

func (sDate) MarshalJSON() ([]byte,error)

typeDestinationNotCrawlableEvidence

type DestinationNotCrawlableEvidence struct {// CrawlTime: Approximate time of the crawl.CrawlTimestring `json:"crawlTime,omitempty"`// CrawledUrl: Destination URL that was attempted to be crawled.CrawledUrlstring `json:"crawledUrl,omitempty"`// Reason: Reason of destination not crawlable.//// Possible values://   "REASON_UNSPECIFIED" - Default value that should never be used.//   "UNREACHABLE_ROBOTS" - Site's robots exclusion file (for example,// robots.txt) was unreachable.//   "TIMEOUT_ROBOTS" - Timed out reading site's robots exclusion file (for// example, robots.txt).//   "ROBOTED_DENIED" - Crawler was disallowed by the site's robots exclusion// file (for example, robots.txt).//   "UNKNOWN" - Unknown reason.Reasonstring `json:"reason,omitempty"`// ForceSendFields is a list of field names (e.g. "CrawlTime") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "CrawlTime") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

DestinationNotCrawlableEvidence: Evidence that the creative's destinationURL was not crawlable by Google.

func (DestinationNotCrawlableEvidence)MarshalJSON

func (sDestinationNotCrawlableEvidence) MarshalJSON() ([]byte,error)

typeDestinationNotWorkingEvidence

type DestinationNotWorkingEvidence struct {// DnsError: DNS lookup errors.//// Possible values://   "DNS_ERROR_UNSPECIFIED" - Default value that should never be used.//   "ERROR_DNS" - DNS name was not found.//   "GOOGLE_CRAWLER_DNS_ISSUE" - An internal issue occurred when Google's// crawler tried to resolve the DNS entry. This is a Google-internal issue and// may not be the result of an issue with the landing page.DnsErrorstring `json:"dnsError,omitempty"`// ExpandedUrl: The full non-working URL.ExpandedUrlstring `json:"expandedUrl,omitempty"`// HttpError: HTTP error code (for example, 404 or 5xx)HttpErrorint64 `json:"httpError,omitempty"`// InvalidPage: Page was crawled successfully, but was detected as either a// page with no content or an error page.//// Possible values://   "INVALID_PAGE_UNSPECIFIED" - Default value that should never be used.//   "EMPTY_OR_ERROR_PAGE" - Page was empty or had an error.InvalidPagestring `json:"invalidPage,omitempty"`// LastCheckTime: Approximate time when the ad destination was last checked.LastCheckTimestring `json:"lastCheckTime,omitempty"`// Platform: Platform of the non-working URL.//// Possible values://   "PLATFORM_UNSPECIFIED" - Default value that should never be used.//   "PERSONAL_COMPUTER" - The personal computer platform.//   "ANDROID" - The Android platform.//   "IOS" - The iOS platform.Platformstring `json:"platform,omitempty"`// RedirectionError: HTTP redirect chain error.//// Possible values://   "REDIRECTION_ERROR_UNSPECIFIED" - Default value that should never be used.//   "TOO_MANY_REDIRECTS" - Too many redirect hops.//   "INVALID_REDIRECT" - Got a redirect but it was invalid.//   "EMPTY_REDIRECT" - Got a redirect but it was empty.//   "REDIRECT_ERROR_UNKNOWN" - Unknown redirect error.RedirectionErrorstring `json:"redirectionError,omitempty"`// UrlRejected: Rejected because of malformed URLs or invalid requests.//// Possible values://   "URL_REJECTED_UNSPECIFIED" - Default value that should never be used.//   "BAD_REQUEST" - URL rejected because of a malformed request.//   "MALFORMED_URL" - URL rejected because of a malformed URL.//   "URL_REJECTED_UNKNOWN" - URL rejected because of unknown reason.UrlRejectedstring `json:"urlRejected,omitempty"`// ForceSendFields is a list of field names (e.g. "DnsError") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "DnsError") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

DestinationNotWorkingEvidence: Evidence of the creative's destination URLnot functioning properly or having been incorrectly set up.

func (DestinationNotWorkingEvidence)MarshalJSON

func (sDestinationNotWorkingEvidence) MarshalJSON() ([]byte,error)

typeDestinationUrlEvidence

type DestinationUrlEvidence struct {// DestinationUrl: The full landing page URL of the destination.DestinationUrlstring `json:"destinationUrl,omitempty"`// ForceSendFields is a list of field names (e.g. "DestinationUrl") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "DestinationUrl") to include in// API requests with the JSON null value. By default, fields with empty values// are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

DestinationUrlEvidence: The full landing page URL of the destination.

func (DestinationUrlEvidence)MarshalJSON

func (sDestinationUrlEvidence) MarshalJSON() ([]byte,error)

typeDomainCallEvidence

type DomainCallEvidence struct {// TopHttpCallDomains: Breakdown of the most frequent domains called through// HTTP by the creative.TopHttpCallDomains []*DomainCalls `json:"topHttpCallDomains,omitempty"`// TotalHttpCallCount: The total number of HTTP calls made by the creative,// including but not limited to the number of calls in the// top_http_call_domains.TotalHttpCallCountint64 `json:"totalHttpCallCount,omitempty"`// ForceSendFields is a list of field names (e.g. "TopHttpCallDomains") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "TopHttpCallDomains") to include// in API requests with the JSON null value. By default, fields with empty// values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

DomainCallEvidence: Number of HTTP calls made by a creative, broken down bydomain.

func (DomainCallEvidence)MarshalJSON

func (sDomainCallEvidence) MarshalJSON() ([]byte,error)

typeDomainCalls

type DomainCalls struct {// Domain: The domain name.Domainstring `json:"domain,omitempty"`// HttpCallCount: Number of HTTP calls made to the domain.HttpCallCountint64 `json:"httpCallCount,omitempty"`// ForceSendFields is a list of field names (e.g. "Domain") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Domain") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

DomainCalls: The number of HTTP calls made to the given domain.

func (DomainCalls)MarshalJSON

func (sDomainCalls) MarshalJSON() ([]byte,error)

typeDownloadSizeEvidence

type DownloadSizeEvidence struct {// TopUrlDownloadSizeBreakdowns: Download size broken down by URLs with the top// download size.TopUrlDownloadSizeBreakdowns []*UrlDownloadSize `json:"topUrlDownloadSizeBreakdowns,omitempty"`// TotalDownloadSizeKb: Total download size (in kilobytes) for all the// resources in the creative.TotalDownloadSizeKbint64 `json:"totalDownloadSizeKb,omitempty"`// ForceSendFields is a list of field names (e.g.// "TopUrlDownloadSizeBreakdowns") to unconditionally include in API requests.// By default, fields with empty or default values are omitted from API// requests. Seehttps://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields// for more details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "TopUrlDownloadSizeBreakdowns") to// include in API requests with the JSON null value. By default, fields with// empty values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

DownloadSizeEvidence: Total download size and URL-level download sizebreakdown for resources in a creative.

func (DownloadSizeEvidence)MarshalJSON

func (sDownloadSizeEvidence) MarshalJSON() ([]byte,error)

typeEmptyadded inv0.36.0

type Empty struct {// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`}

Empty: A generic empty message that you can re-use to avoid definingduplicated empty messages in your APIs. A typical example is to use it asthe request or the response type of an API method. For instance: service Foo{ rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

typeEndpointadded inv0.42.0

type Endpoint struct {// BidProtocol: The protocol that the bidder endpoint is using.//// Possible values://   "BID_PROTOCOL_UNSPECIFIED" - Placeholder for undefined bid protocol. This// value should not be used.//   "GOOGLE_RTB" - Google RTB protocol / Protobuf encoding.//   "OPENRTB_JSON" - OpenRTB / JSON encoding (unversioned/latest).//   "OPENRTB_PROTOBUF" - OpenRTB / Protobuf encoding (unversioned/latest).BidProtocolstring `json:"bidProtocol,omitempty"`// MaximumQps: The maximum number of queries per second allowed to be sent to// this server.MaximumQpsint64 `json:"maximumQps,omitempty,string"`// Name: Output only. Name of the endpoint resource that must follow the// pattern `bidders/{bidderAccountId}/endpoints/{endpointId}`, where// {bidderAccountId} is the account ID of the bidder who operates this// endpoint, and {endpointId} is a unique ID assigned by the server.Namestring `json:"name,omitempty"`// TradingLocation: The trading location that bid requests should be sent from.// See//https://developers.google.com/authorized-buyers/rtb/peer-guide#trading-locations// for further information.//// Possible values://   "TRADING_LOCATION_UNSPECIFIED" - A placeholder for an undefined trading// region. This value should not be used.//   "US_WEST" - The Western US trading location.//   "US_EAST" - The Eastern US trading location.//   "EUROPE" - The European trading location.//   "ASIA" - The Asia trading location.TradingLocationstring `json:"tradingLocation,omitempty"`// Url: Output only. The URL that bid requests should be sent to.Urlstring `json:"url,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "BidProtocol") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "BidProtocol") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

Endpoint: Bidder endpoint that receives bid requests.

func (Endpoint)MarshalJSONadded inv0.42.0

func (sEndpoint) MarshalJSON() ([]byte,error)

typeGetRemarketingTagResponse

type GetRemarketingTagResponse struct {// Snippet: An HTML tag that can be placed on the advertiser's page to add// users to a user list. For more information and code samples on using// snippets on your website, refer to Tag your site for remarketing// (https://support.google.com/google-ads/answer/2476688).Snippetstring `json:"snippet,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "Snippet") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Snippet") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

GetRemarketingTagResponse: This has been sunset as of October 2023, and willreturn an error response if called. For more information, see the releasenotes:https://developers.google.com/authorized-buyers/apis/relnotes#real-time-bidding-apiResponse for a request to get remarketing tag.

func (GetRemarketingTagResponse)MarshalJSON

func (sGetRemarketingTagResponse) MarshalJSON() ([]byte,error)

typeHtmlContent

type HtmlContent struct {// Height: The height of the HTML snippet in pixels. Can be used to filter the// response of the creatives.list method.Heightint64 `json:"height,omitempty"`// Snippet: The HTML snippet that displays the ad when inserted in the web// page.Snippetstring `json:"snippet,omitempty"`// Width: The width of the HTML snippet in pixels. Can be used to filter the// response of the creatives.list method.Widthint64 `json:"width,omitempty"`// ForceSendFields is a list of field names (e.g. "Height") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Height") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

HtmlContent: HTML content for a creative.

func (HtmlContent)MarshalJSON

func (sHtmlContent) MarshalJSON() ([]byte,error)

typeHttpCallEvidence

type HttpCallEvidence struct {// Urls: URLs of HTTP calls made by the creative.Urls []string `json:"urls,omitempty"`// ForceSendFields is a list of field names (e.g. "Urls") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Urls") to include in API requests// with the JSON null value. By default, fields with empty values are omitted// from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

HttpCallEvidence: HTTP calls made by a creative that resulted in policyviolations.

func (HttpCallEvidence)MarshalJSON

func (sHttpCallEvidence) MarshalJSON() ([]byte,error)

typeHttpCookieEvidence

type HttpCookieEvidence struct {// CookieNames: Names of cookies that violate Google policies. For// TOO_MANY_COOKIES policy, this will be the cookie names of top domains with// the largest number of cookies. For other policies, this will be all the// cookie names that violate the policy.CookieNames []string `json:"cookieNames,omitempty"`// MaxCookieCount: The largest number of cookies set by a creative. If this// field is set, cookie_names above will be set to the cookie names of top// domains with the largest number of cookies. This field will only be set for// TOO_MANY_COOKIES policy.MaxCookieCountint64 `json:"maxCookieCount,omitempty"`// ForceSendFields is a list of field names (e.g. "CookieNames") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "CookieNames") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

HttpCookieEvidence: Evidence for HTTP cookie-related policy violations.

func (HttpCookieEvidence)MarshalJSON

func (sHttpCookieEvidence) MarshalJSON() ([]byte,error)

typeImage

type Image struct {// Height: Image height in pixels.Heightint64 `json:"height,omitempty"`// Url: The URL of the image.Urlstring `json:"url,omitempty"`// Width: Image width in pixels.Widthint64 `json:"width,omitempty"`// ForceSendFields is a list of field names (e.g. "Height") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Height") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

Image: An image resource. You may provide a larger image than was requested,so long as the aspect ratio is preserved.

func (Image)MarshalJSON

func (sImage) MarshalJSON() ([]byte,error)

typeListBiddersResponseadded inv0.42.0

type ListBiddersResponse struct {// Bidders: List of bidders.Bidders []*Bidder `json:"bidders,omitempty"`// NextPageToken: A token which can be passed to a subsequent call to the// `ListBidders` method to retrieve the next page of results in// ListBiddersRequest.pageToken.NextPageTokenstring `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. "Bidders") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Bidders") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListBiddersResponse: A response containing bidders.

func (ListBiddersResponse)MarshalJSONadded inv0.42.0

func (sListBiddersResponse) MarshalJSON() ([]byte,error)

typeListBuyersResponseadded inv0.42.0

type ListBuyersResponse struct {// Buyers: List of buyers.Buyers []*Buyer `json:"buyers,omitempty"`// NextPageToken: A token which can be passed to a subsequent call to the// `ListBuyers` method to retrieve the next page of results in// ListBuyersRequest.pageToken.NextPageTokenstring `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. "Buyers") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Buyers") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListBuyersResponse: A response containing buyer account information.

func (ListBuyersResponse)MarshalJSONadded inv0.42.0

func (sListBuyersResponse) MarshalJSON() ([]byte,error)

typeListCreativesResponse

type ListCreativesResponse struct {// Creatives: The list of creatives.Creatives []*Creative `json:"creatives,omitempty"`// NextPageToken: A token to retrieve the next page of results. Pass this value// in the ListCreativesRequest.pageToken field in the subsequent call to the// `ListCreatives` method to retrieve the next page of results.NextPageTokenstring `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. "Creatives") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Creatives") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListCreativesResponse: A response for listing creatives.

func (ListCreativesResponse)MarshalJSON

func (sListCreativesResponse) MarshalJSON() ([]byte,error)

typeListEndpointsResponseadded inv0.42.0

type ListEndpointsResponse struct {// Endpoints: List of bidder endpoints.Endpoints []*Endpoint `json:"endpoints,omitempty"`// NextPageToken: A token which can be passed to a subsequent call to the// `ListEndpoints` method to retrieve the next page of results in// ListEndpointsRequest.pageToken.NextPageTokenstring `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. "Endpoints") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Endpoints") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListEndpointsResponse: A response containing bidder endpoints.

func (ListEndpointsResponse)MarshalJSONadded inv0.42.0

func (sListEndpointsResponse) MarshalJSON() ([]byte,error)

typeListPretargetingConfigsResponseadded inv0.36.0

type ListPretargetingConfigsResponse struct {// NextPageToken: A token which can be passed to a subsequent call to the// `ListPretargetingConfigs` method to retrieve the next page of results in// ListPretargetingConfigsRequest.pageToken.NextPageTokenstring `json:"nextPageToken,omitempty"`// PretargetingConfigs: List of pretargeting configurations.PretargetingConfigs []*PretargetingConfig `json:"pretargetingConfigs,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "NextPageToken") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "NextPageToken") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListPretargetingConfigsResponse: A response containing pretargetingconfigurations.

func (ListPretargetingConfigsResponse)MarshalJSONadded inv0.36.0

func (sListPretargetingConfigsResponse) MarshalJSON() ([]byte,error)

typeListPublisherConnectionsResponseadded inv0.79.0

type ListPublisherConnectionsResponse struct {// NextPageToken: A token to retrieve the next page of results. Pass this value// in the ListPublisherConnectionsRequest.pageToken field in the subsequent// call to the `ListPublisherConnections` method to retrieve the next page of// results.NextPageTokenstring `json:"nextPageToken,omitempty"`// PublisherConnections: The list of publisher connections.PublisherConnections []*PublisherConnection `json:"publisherConnections,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "NextPageToken") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "NextPageToken") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListPublisherConnectionsResponse: A response to a request for listingpublisher connections.

func (ListPublisherConnectionsResponse)MarshalJSONadded inv0.79.0

func (sListPublisherConnectionsResponse) MarshalJSON() ([]byte,error)

typeListUserListsResponse

type ListUserListsResponse struct {// NextPageToken: The continuation page token to send back to the server in a// subsequent request. Due to a currently known issue, it is recommended that// the caller keep invoking the list method until the time a next page token is// not returned, even if the result set is empty.NextPageTokenstring `json:"nextPageToken,omitempty"`// UserLists: List of user lists from the search.UserLists []*UserList `json:"userLists,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "NextPageToken") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "NextPageToken") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

ListUserListsResponse: The list user list response.

func (ListUserListsResponse)MarshalJSON

func (sListUserListsResponse) MarshalJSON() ([]byte,error)

typeMediaFile

type MediaFile struct {// Bitrate: Bitrate of the video file, in Kbps. Can be used to filter the// response of the creatives.list method.Bitrateint64 `json:"bitrate,omitempty,string"`// MimeType: The MIME type of this media file. Can be used to filter the// response of the creatives.list method.//// Possible values://   "VIDEO_MIME_TYPE_UNSPECIFIED" - Default value that should never be used.//   "MIME_VIDEO_XFLV" - Flash container.//   "MIME_VIDEO_WEBM" - WebM container assuming VP9 codec.//   "MIME_VIDEO_MP4" - MPEG-4 container typically with H.264 codec.//   "MIME_VIDEO_OGG" - Ogg container assuming Theora codec.//   "MIME_VIDEO_YT_HOSTED" - Video files hosted on YouTube.//   "MIME_VIDEO_X_MS_WMV" - Windows Media Video Codec.//   "MIME_VIDEO_3GPP" - 3GPP container format used on 3G phones.//   "MIME_VIDEO_MOV" - Quicktime container format.//   "MIME_APPLICATION_SWF" - Shockwave Flash (used for VPAID ads).//   "MIME_APPLICATION_SURVEY" - Properties of VAST served by consumer survey.//   "MIME_APPLICATION_JAVASCRIPT" - JavaScript (used for VPAID ads).//   "MIME_APPLICATION_SILVERLIGHT" - Silverlight (used for VPAID ads).//   "MIME_APPLICATION_MPEGURL" - HLS/M3U8.//   "MIME_APPLICATION_MPEGDASH" - DASH.//   "MIME_AUDIO_MP4A" - MPEG-4 audio format.//   "MIME_AUDIO_MP3" - MPEG-3 audio format.//   "MIME_AUDIO_OGG" - Ogg audio formatMimeTypestring `json:"mimeType,omitempty"`// ForceSendFields is a list of field names (e.g. "Bitrate") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Bitrate") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

MediaFile: Information about each media file in the VAST.

func (MediaFile)MarshalJSON

func (sMediaFile) MarshalJSON() ([]byte,error)

typeNativeContent

type NativeContent struct {// AdvertiserName: The name of the advertiser or sponsor, to be displayed in// the ad creative.AdvertiserNamestring `json:"advertiserName,omitempty"`// AppIcon: The app icon, for app download ads.AppIcon *Image `json:"appIcon,omitempty"`// Body: A long description of the ad.Bodystring `json:"body,omitempty"`// CallToAction: A label for the button that the user is supposed to click.CallToActionstring `json:"callToAction,omitempty"`// ClickLinkUrl: The URL that the browser/SDK will load when the user clicks// the ad.ClickLinkUrlstring `json:"clickLinkUrl,omitempty"`// ClickTrackingUrl: The URL to use for click tracking.ClickTrackingUrlstring `json:"clickTrackingUrl,omitempty"`// Headline: A short title for the ad.Headlinestring `json:"headline,omitempty"`// Image: A large image.Image *Image `json:"image,omitempty"`// Logo: A smaller image, for the advertiser's logo.Logo *Image `json:"logo,omitempty"`// PriceDisplayText: The price of the promoted app including currency info.PriceDisplayTextstring `json:"priceDisplayText,omitempty"`// StarRating: The app rating in the app store. Must be in the range [0-5].StarRatingfloat64 `json:"starRating,omitempty"`// VideoUrl: The URL to fetch a native video ad.VideoUrlstring `json:"videoUrl,omitempty"`// VideoVastXml: The contents of a VAST document for a native video ad.VideoVastXmlstring `json:"videoVastXml,omitempty"`// ForceSendFields is a list of field names (e.g. "AdvertiserName") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AdvertiserName") to include in// API requests with the JSON null value. By default, fields with empty values// are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

NativeContent: Native content for a creative.

func (NativeContent)MarshalJSON

func (sNativeContent) MarshalJSON() ([]byte,error)

func (*NativeContent)UnmarshalJSON

func (s *NativeContent) UnmarshalJSON(data []byte)error

typeNumericTargetingDimensionadded inv0.36.0

type NumericTargetingDimension struct {// ExcludedIds: The IDs excluded in a configuration.ExcludedIdsgoogleapi.Int64s `json:"excludedIds,omitempty"`// IncludedIds: The IDs included in a configuration.IncludedIdsgoogleapi.Int64s `json:"includedIds,omitempty"`// ForceSendFields is a list of field names (e.g. "ExcludedIds") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "ExcludedIds") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

NumericTargetingDimension: Generic targeting used for targeting dimensionsthat contain a list of included and excluded numeric IDs used in app, userlist, geo, and vertical id targeting.

func (NumericTargetingDimension)MarshalJSONadded inv0.36.0

func (sNumericTargetingDimension) MarshalJSON() ([]byte,error)

typeOpenUserListRequest

type OpenUserListRequest struct {}

OpenUserListRequest: A request to open a specified user list.

typePolicyComplianceadded inv0.33.0

type PolicyCompliance struct {// Status: Serving status for the given transaction type (for example, open// auction, deals) or region (for example, China, Russia). Can be used to// filter the response of the creatives.list method.//// Possible values://   "STATUS_UNSPECIFIED" - Default value that should never be used.//   "PENDING_REVIEW" - Creative is pending review.//   "DISAPPROVED" - Creative cannot serve.//   "APPROVED" - Creative is approved.//   "CERTIFICATE_REQUIRED" - Certificates are required for the creative to be// served in some regions. For more information about creative certification,// refer to:https://support.google.com/authorizedbuyers/answer/7450776Statusstring `json:"status,omitempty"`// Topics: Topics related to the policy compliance for this transaction type// (for example, open auction, deals) or region (for example, China, Russia).// Topics may be present only if status is DISAPPROVED.Topics []*PolicyTopicEntry `json:"topics,omitempty"`// ForceSendFields is a list of field names (e.g. "Status") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Status") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

PolicyCompliance: Policy compliance of the creative for a transaction typeor a region.

func (PolicyCompliance)MarshalJSONadded inv0.33.0

func (sPolicyCompliance) MarshalJSON() ([]byte,error)

typePolicyTopicEntry

type PolicyTopicEntry struct {// Evidences: Pieces of evidence associated with this policy topic entry.Evidences []*PolicyTopicEvidence `json:"evidences,omitempty"`// HelpCenterUrl: URL of the help center article describing this policy topic.HelpCenterUrlstring `json:"helpCenterUrl,omitempty"`// MissingCertificate: Whether or not the policy topic is missing a// certificate. Some policy topics require a certificate to unblock serving in// some regions. For more information about creative certification, refer to://https://support.google.com/authorizedbuyers/answer/7450776MissingCertificatebool `json:"missingCertificate,omitempty"`// PolicyTopic: Policy topic this entry refers to. For example, "ALCOHOL",// "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible// policy topics is not fixed for a particular API version and may change at// any time. Can be used to filter the response of the creatives.list methodPolicyTopicstring `json:"policyTopic,omitempty"`// ForceSendFields is a list of field names (e.g. "Evidences") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Evidences") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

PolicyTopicEntry: Each policy topic entry will represent a violation of apolicy topic for a creative, with the policy topic information and optionalevidence for the policy violation.

func (PolicyTopicEntry)MarshalJSON

func (sPolicyTopicEntry) MarshalJSON() ([]byte,error)

typePolicyTopicEvidence

type PolicyTopicEvidence struct {// DestinationNotCrawlable: The creative's destination URL was not crawlable by// Google.DestinationNotCrawlable *DestinationNotCrawlableEvidence `json:"destinationNotCrawlable,omitempty"`// DestinationNotWorking: The creative's destination URL did not function// properly or was incorrectly set up.DestinationNotWorking *DestinationNotWorkingEvidence `json:"destinationNotWorking,omitempty"`// DestinationUrl: URL of the actual landing page.DestinationUrl *DestinationUrlEvidence `json:"destinationUrl,omitempty"`// DomainCall: Number of HTTP calls made by the creative, broken down by// domain.DomainCall *DomainCallEvidence `json:"domainCall,omitempty"`// DownloadSize: Total download size and URL-level download size breakdown for// resources in a creative.DownloadSize *DownloadSizeEvidence `json:"downloadSize,omitempty"`// HttpCall: HTTP calls made by the creative that resulted in policy// violations.HttpCall *HttpCallEvidence `json:"httpCall,omitempty"`// HttpCookie: Evidence for HTTP cookie-related policy violations.HttpCookie *HttpCookieEvidence `json:"httpCookie,omitempty"`// ForceSendFields is a list of field names (e.g. "DestinationNotCrawlable") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "DestinationNotCrawlable") to// include in API requests with the JSON null value. By default, fields with// empty values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

PolicyTopicEvidence: Evidence associated with a policy topic entry.

func (PolicyTopicEvidence)MarshalJSON

func (sPolicyTopicEvidence) MarshalJSON() ([]byte,error)

typePretargetingConfigadded inv0.36.0

type PretargetingConfig struct {// AllowedUserTargetingModes: Targeting modes included by this configuration. A// bid request must allow all the specified targeting modes. An unset value// allows all bid requests to be sent, regardless of which targeting modes they// allow.//// Possible values://   "USER_TARGETING_MODE_UNSPECIFIED" - Placeholder for undefined user// targeting mode.//   "REMARKETING_ADS" - Remarketing ads are allowed to serve.//   "INTEREST_BASED_TARGETING" - Ads based on user interest category targeting// are allowed to serve.AllowedUserTargetingModes []string `json:"allowedUserTargetingModes,omitempty"`// AppTargeting: Targeting on a subset of app inventory. If APP is listed in// targeted_environments, the specified targeting is applied. A maximum of// 30,000 app IDs can be targeted. An unset value for targeting allows all// app-based bid requests to be sent. Apps can either be targeting positively// (bid requests will be sent only if the destination app is listed in the// targeting dimension) or negatively (bid requests will be sent only if the// destination app is not listed in the targeting dimension).AppTargeting *AppTargeting `json:"appTargeting,omitempty"`// BillingId: Output only. The identifier that corresponds to this pretargeting// configuration that helps buyers track and attribute their spend across their// own arbitrary divisions. If a bid request matches more than one// configuration, the buyer chooses which billing_id to attribute each of their// bids.BillingIdint64 `json:"billingId,omitempty,string"`// DisplayName: The diplay name associated with this configuration. This name// must be unique among all the pretargeting configurations a bidder has.DisplayNamestring `json:"displayName,omitempty"`// ExcludedContentLabelIds: The sensitive content category label IDs excluded// in this configuration. Bid requests for inventory with any of the specified// content label IDs will not be sent. Refer to this file//https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for// category IDs.ExcludedContentLabelIdsgoogleapi.Int64s `json:"excludedContentLabelIds,omitempty"`// GeoTargeting: The geos included or excluded in this configuration defined in//https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csvGeoTargeting *NumericTargetingDimension `json:"geoTargeting,omitempty"`// IncludedCreativeDimensions: Creative dimensions included by this// configuration. Only bid requests eligible for at least one of the specified// creative dimensions will be sent. An unset value allows all bid requests to// be sent, regardless of creative dimension.IncludedCreativeDimensions []*CreativeDimensions `json:"includedCreativeDimensions,omitempty"`// IncludedEnvironments: Environments that are being included. Bid requests// will not be sent for a given environment if it is not included. Further// restrictions can be applied to included environments to target only a subset// of its inventory. An unset value includes all environments.//// Possible values://   "ENVIRONMENT_UNSPECIFIED" - Placeholder for unspecified environment. This// value should not be used.//   "APP" - App environment.//   "WEB" - Web environment.IncludedEnvironments []string `json:"includedEnvironments,omitempty"`// IncludedFormats: Creative formats included by this configuration. Only bid// requests eligible for at least one of the specified creative formats will be// sent. An unset value will allow all bid requests to be sent, regardless of// format.//// Possible values://   "CREATIVE_FORMAT_UNSPECIFIED" - Placeholder for undefined creative format.// This value should not be used.//   "HTML" - HTML and AMPHTML creatives.//   "VAST" - VAST video or audio creative.//   "NATIVE" - Native creative, including standard and video native ads.IncludedFormats []string `json:"includedFormats,omitempty"`// IncludedLanguages: The languages included in this configuration, represented// by their language code. See//https://developers.google.com/adwords/api/docs/appendix/languagecodes.IncludedLanguages []string `json:"includedLanguages,omitempty"`// IncludedMobileOperatingSystemIds: The mobile operating systems included in// this configuration as defined in//https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csvIncludedMobileOperatingSystemIdsgoogleapi.Int64s `json:"includedMobileOperatingSystemIds,omitempty"`// IncludedPlatforms: The platforms included by this configration. Bid requests// for devices with the specified platform types will be sent. An unset value// allows all bid requests to be sent, regardless of platform.//// Possible values://   "PLATFORM_UNSPECIFIED" - Placeholder for an undefined platform. This value// should not be used.//   "PERSONAL_COMPUTER" - The personal computer platform.//   "PHONE" - The mobile platform.//   "TABLET" - The tablet platform.//   "CONNECTED_TV" - The connected TV platform.IncludedPlatforms []string `json:"includedPlatforms,omitempty"`// IncludedUserIdTypes: User identifier types included in this configuration.// At least one of the user identifier types specified in this list must be// available for the bid request to be sent.//// Possible values://   "USER_ID_TYPE_UNSPECIFIED" - Placeholder for unspecified user identifier.//   "HOSTED_MATCH_DATA" - Hosted match data, referring to hosted_match_data in// the bid request.//   "GOOGLE_COOKIE" - Google cookie, referring to google_user_id in the bid// request.//   "DEVICE_ID" - Mobile device advertising ID.//   "PUBLISHER_PROVIDED_ID" - The request has a publisher-provided ID// available to the bidder.//   "PUBLISHER_FIRST_PARTY_ID" - Publisher first party ID, scoped to a single// site, app or vendor needs to be present on the bid request.IncludedUserIdTypes []string `json:"includedUserIdTypes,omitempty"`// InterstitialTargeting: The interstitial targeting specified for this// configuration. The unset value will allow bid requests to be sent regardless// of whether they are for interstitials or not.//// Possible values://   "INTERSTITIAL_TARGETING_UNSPECIFIED" - Unspecified interstitial targeting.// Represents an interstitial-agnostic selection.//   "ONLY_INTERSTITIAL_REQUESTS" - Only bid requests for interstitial// inventory should be sent.//   "ONLY_NON_INTERSTITIAL_REQUESTS" - Only bid requests for non-interstitial// inventory should be sent.InterstitialTargetingstring `json:"interstitialTargeting,omitempty"`// InvalidGeoIds: Output only. Existing included or excluded geos that are// invalid. Previously targeted geos may become invalid due to privacy// restrictions.InvalidGeoIdsgoogleapi.Int64s `json:"invalidGeoIds,omitempty"`// MaximumQps: The maximum QPS threshold for this configuration. The bidder// should receive no more than this number of bid requests matching this// configuration per second across all their bidding endpoints among all// trading locations. Further information available at//https://developers.google.com/authorized-buyers/rtb/peer-guideMaximumQpsint64 `json:"maximumQps,omitempty,string"`// MinimumViewabilityDecile: The targeted minimum viewability decile, ranging// in values [0, 10]. A value of 5 means that the configuration will only match// adslots for which we predict at least 50% viewability. Values > 10 will be// rounded down to 10. An unset value or a value of 0 indicates that bid// requests will be sent regardless of viewability.MinimumViewabilityDecileint64 `json:"minimumViewabilityDecile,omitempty"`// Name: Output only. Name of the pretargeting configuration that must follow// the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`Namestring `json:"name,omitempty"`// PublisherTargeting: Targeting on a subset of publisher inventory. Publishers// can either be targeted positively (bid requests will be sent only if the// publisher is listed in the targeting dimension) or negatively (bid requests// will be sent only if the publisher is not listed in the targeting// dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs// are found in ads.txt (https://iabtechlab.com/ads-txt/) / app-ads.txt// (https://iabtechlab.com/app-ads-txt/) and in bid requests in the// `BidRequest.publisher_id` field on the Google RTB protocol// (https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto)// or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field// on the OpenRTB protocol// (https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).// Publisher IDs will be returned in the order that they were entered.PublisherTargeting *StringTargetingDimension `json:"publisherTargeting,omitempty"`// State: Output only. The state of this pretargeting configuration.//// Possible values://   "STATE_UNSPECIFIED" - Placeholder for undefined state.//   "ACTIVE" - This pretargeting configuration is actively being used to// filter bid requests.//   "SUSPENDED" - This pretargeting configuration is suspended and not used in// serving.Statestring `json:"state,omitempty"`// UserListTargeting: The remarketing lists included or excluded in this// configuration as defined in UserList.UserListTargeting *NumericTargetingDimension `json:"userListTargeting,omitempty"`// VerticalTargeting: The verticals included or excluded in this configuration// as defined in//https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticalsVerticalTargeting *NumericTargetingDimension `json:"verticalTargeting,omitempty"`// WebTargeting: Targeting on a subset of site inventory. If WEB is listed in// included_environments, the specified targeting is applied. A maximum of// 50,000 site URLs can be targeted. An unset value for targeting allows all// web-based bid requests to be sent. Sites can either be targeting positively// (bid requests will be sent only if the destination site is listed in the// targeting dimension) or negatively (bid requests will be sent only if the// destination site is not listed in the pretargeting configuration).WebTargeting *StringTargetingDimension `json:"webTargeting,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "AllowedUserTargetingModes")// to unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AllowedUserTargetingModes") to// include in API requests with the JSON null value. By default, fields with// empty values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

PretargetingConfig: Pretargeting configuration: a set of targetingdimensions applied at the pretargeting stage of the RTB funnel. Thesecontrol which inventory a bidder will receive bid requests for.

func (PretargetingConfig)MarshalJSONadded inv0.36.0

func (sPretargetingConfig) MarshalJSON() ([]byte,error)

typePublisherConnectionadded inv0.79.0

type PublisherConnection struct {// BiddingState: Whether the publisher has been approved by the bidder.//// Possible values://   "STATE_UNSPECIFIED" - An unspecified bidding status.//   "PENDING" - Indicates a request for connection from the publisher that the// bidder needs to review.//   "REJECTED" - Indicates that the publisher was rejected.//   "APPROVED" - Indicates that the publisher was approved.BiddingStatestring `json:"biddingState,omitempty"`// CreateTime: Output only. The time at which the publisher initiated a// connection with the bidder (irrespective of if or when the bidder approves// it). This is subsequently updated if the publisher revokes and re-initiates// the connection.CreateTimestring `json:"createTime,omitempty"`// DisplayName: Output only. Publisher display name.DisplayNamestring `json:"displayName,omitempty"`// Name: Output only. Name of the publisher connection. This follows the// pattern `bidders/{bidder}/publisherConnections/{publisher}`, where// `{bidder}` represents the account ID of the bidder, and `{publisher}` is the// ads.txt/app-ads.txt publisher ID.Namestring `json:"name,omitempty"`// PublisherPlatform: Output only. Whether the publisher is an Ad Manager or// AdMob publisher.//// Possible values://   "PUBLISHER_PLATFORM_UNSPECIFIED" - An unspecified publisher platform.//   "GOOGLE_AD_MANAGER" - A Google Ad Manager publisher.//   "ADMOB" - An AdMob publisher.PublisherPlatformstring `json:"publisherPlatform,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "BiddingState") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "BiddingState") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

PublisherConnection: An Open Bidding exchange's connection to a publisher.This is initiated by the publisher for the bidder to review. If approved bythe bidder, this means that the bidder agrees to receive bid requests fromthe publisher.

func (PublisherConnection)MarshalJSONadded inv0.79.0

func (sPublisherConnection) MarshalJSON() ([]byte,error)

typeRemoveTargetedAppsRequestadded inv0.36.0

type RemoveTargetedAppsRequest struct {// AppIds: A list of app IDs to stop targeting in the pretargeting// configuration. These values will be removed from the list of targeted app// IDs in PretargetingConfig.appTargeting.mobileAppTargeting.values.AppIds []string `json:"appIds,omitempty"`// ForceSendFields is a list of field names (e.g. "AppIds") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "AppIds") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

RemoveTargetedAppsRequest: A request to stop targeting the provided apps ina specific pretargeting configuration. The pretargeting configuration itselfspecifies how these apps are targeted. inPretargetingConfig.appTargeting.mobileAppTargeting.

func (RemoveTargetedAppsRequest)MarshalJSONadded inv0.36.0

func (sRemoveTargetedAppsRequest) MarshalJSON() ([]byte,error)

typeRemoveTargetedPublishersRequestadded inv0.36.0

type RemoveTargetedPublishersRequest struct {// PublisherIds: A list of publisher IDs to stop targeting in the pretargeting// configuration. These values will be removed from the list of targeted// publisher IDs in PretargetingConfig.publisherTargeting.values. Publishers// are identified by their publisher ID from ads.txt / app-ads.txt. See//https://iabtechlab.com/ads-txt/ andhttps://iabtechlab.com/app-ads-txt/ for// more details.PublisherIds []string `json:"publisherIds,omitempty"`// ForceSendFields is a list of field names (e.g. "PublisherIds") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "PublisherIds") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

RemoveTargetedPublishersRequest: A request to stop targeting publishers in aspecific configuration. The pretargeting configuration itself specifies howthese publishers are targeted in PretargetingConfig.publisherTargeting.

func (RemoveTargetedPublishersRequest)MarshalJSONadded inv0.36.0

func (sRemoveTargetedPublishersRequest) MarshalJSON() ([]byte,error)

typeRemoveTargetedSitesRequestadded inv0.36.0

type RemoveTargetedSitesRequest struct {// Sites: A list of site URLs to stop targeting in the pretargeting// configuration. These values will be removed from the list of targeted URLs// in PretargetingConfig.webTargeting.values.Sites []string `json:"sites,omitempty"`// ForceSendFields is a list of field names (e.g. "Sites") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Sites") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

RemoveTargetedSitesRequest: A request to stop targeting sites in a specificpretargeting configuration. The pretargeting configuration itself specifieshow these sites are targeted in PretargetingConfig.webTargeting.

func (RemoveTargetedSitesRequest)MarshalJSONadded inv0.36.0

func (sRemoveTargetedSitesRequest) MarshalJSON() ([]byte,error)

typeService

type Service struct {BasePathstring// API endpoint base URLUserAgentstring// optional additional User-Agent fragmentBidders *BiddersServiceBuyers *BuyersService// contains filtered or unexported fields}

funcNewdeprecated

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

New creates a new Service. It uses the provided http.Client for requests.

Deprecated: please use NewService instead.To provide a custom HTTP client, use option.WithHTTPClient.If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.

funcNewService

func NewService(ctxcontext.Context, opts ...option.ClientOption) (*Service,error)

NewService creates a new Service.

typeStringTargetingDimensionadded inv0.36.0

type StringTargetingDimension struct {// TargetingMode: How the items in this list should be targeted.//// Possible values://   "TARGETING_MODE_UNSPECIFIED" - Placeholder for undefined targeting mode.//   "INCLUSIVE" - The inclusive list type. Inventory must match an item in// this list to be targeted.//   "EXCLUSIVE" - The exclusive list type. Inventory must not match any item// in this list to be targeted.TargetingModestring `json:"targetingMode,omitempty"`// Values: The values specified.Values []string `json:"values,omitempty"`// ForceSendFields is a list of field names (e.g. "TargetingMode") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "TargetingMode") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

StringTargetingDimension: Generic targeting with string values used in app,website and publisher targeting.

func (StringTargetingDimension)MarshalJSONadded inv0.36.0

func (sStringTargetingDimension) MarshalJSON() ([]byte,error)

typeSuspendPretargetingConfigRequestadded inv0.36.0

type SuspendPretargetingConfigRequest struct {}

SuspendPretargetingConfigRequest: A request to suspend a pretargetingconfiguration. Sets the configuration's state to SUSPENDED.

typeUrlDownloadSize

type UrlDownloadSize struct {// DownloadSizeKb: Download size of the URL in kilobytes.DownloadSizeKbint64 `json:"downloadSizeKb,omitempty"`// NormalizedUrl: The normalized URL with query parameters and fragment// removed.NormalizedUrlstring `json:"normalizedUrl,omitempty"`// ForceSendFields is a list of field names (e.g. "DownloadSizeKb") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "DownloadSizeKb") to include in// API requests with the JSON null value. By default, fields with empty values// are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

UrlDownloadSize: The URL-level breakdown for the download size.

func (UrlDownloadSize)MarshalJSON

func (sUrlDownloadSize) MarshalJSON() ([]byte,error)

typeUrlRestriction

type UrlRestriction struct {// EndDate: End date (if specified) of the URL restriction. End date should be// later than the start date for the date range to be valid.EndDate *Date `json:"endDate,omitempty"`// RestrictionType: The restriction type for the specified URL.//// Possible values://   "RESTRICTION_TYPE_UNSPECIFIED" - Default value that should never be used.//   "CONTAINS" - The tag URL (as recorded by the pixel callback) contains the// specified URL.//   "EQUALS" - The tag URL (as recorded by the pixel callback) exactly matches// the specified URL.//   "STARTS_WITH" - The tag URL (as recorded by the pixel callback) starts// with the specified URL.//   "ENDS_WITH" - The tag URL (as recorded by the pixel callback) ends with// the specified URL.//   "DOES_NOT_EQUAL" - The tag URL (as recorded by the pixel callback) does// not equal the specified URL.//   "DOES_NOT_CONTAIN" - The tag URL (as recorded by the pixel callback) does// not contain the specified URL.//   "DOES_NOT_START_WITH" - The tag URL (as recorded by the pixel callback)// does not start with the specified URL.//   "DOES_NOT_END_WITH" - The tag URL (as recorded by the pixel callback) does// not end with the specified URL.RestrictionTypestring `json:"restrictionType,omitempty"`// StartDate: Start date (if specified) of the URL restriction.StartDate *Date `json:"startDate,omitempty"`// Url: Required. The URL to use for applying the restriction on the user list.Urlstring `json:"url,omitempty"`// ForceSendFields is a list of field names (e.g. "EndDate") to unconditionally// include in API requests. By default, fields with empty or default values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "EndDate") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

UrlRestriction: Deprecated. This will be removed in October 2023. For moreinformation, see the release notes:https://developers.google.com/authorized-buyers/apis/relnotes#real-time-bidding-apiRepresents the URL restriction (for the URL captured by the pixel callback)for a user list.

func (UrlRestriction)MarshalJSON

func (sUrlRestriction) MarshalJSON() ([]byte,error)

typeUserList

type UserList struct {// Description: The description for the user list.Descriptionstring `json:"description,omitempty"`// DisplayName: Required. Display name of the user list. This must be unique// across all user lists for a given account.DisplayNamestring `json:"displayName,omitempty"`// MembershipDurationDays: Required. The number of days a user's cookie stays// on the user list. The field must be between 0 and 540 inclusive.MembershipDurationDaysint64 `json:"membershipDurationDays,omitempty,string"`// Name: Output only. Name of the user list that must follow the pattern// `buyers/{buyer}/userLists/{user_list}`, where `{buyer}` represents the// account ID of the buyer who owns the user list. For a bidder accessing user// lists on behalf of a child seat buyer, `{buyer}` represents the account ID// of the child seat buyer. `{user_list}` is an int64 identifier assigned by// Google to uniquely identify a user list.Namestring `json:"name,omitempty"`// Status: Output only. The status of the user list. A new user list starts out// as open.//// Possible values://   "STATUS_UNSPECIFIED" - Default value that should never be used.//   "OPEN" - New users can be added to the user list.//   "CLOSED" - New users cannot be added to the user list.Statusstring `json:"status,omitempty"`// UrlRestriction: Required. Deprecated. This will be removed in October 2023.// For more information, see the release notes://https://developers.google.com/authorized-buyers/apis/relnotes#real-time-bidding-api// The URL restriction for the user list.UrlRestriction *UrlRestriction `json:"urlRestriction,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "Description") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Description") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

UserList: Represents an Authorized Buyers user list. Authorized Buyers cancreate/update/list user lists. Once a user list is created in the system,Authorized Buyers can add users to the user list using the bulk uploaderAPI. Alternatively, users can be added by hosting a tag on the advertiser'spage.

func (UserList)MarshalJSON

func (sUserList) MarshalJSON() ([]byte,error)

typeVideoContent

type VideoContent struct {// VideoMetadata: Output only. Video metadata.VideoMetadata *VideoMetadata `json:"videoMetadata,omitempty"`// VideoUrl: The URL to fetch a video ad. The URL should return an XML response// that conforms to the VAST 2.0, 3.0 or 4.x standard.VideoUrlstring `json:"videoUrl,omitempty"`// VideoVastXml: The contents of a VAST document for a video ad. This document// should conform to the VAST 2.0, 3.0, or 4.x standard.VideoVastXmlstring `json:"videoVastXml,omitempty"`// ForceSendFields is a list of field names (e.g. "VideoMetadata") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "VideoMetadata") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

VideoContent: Video content for a creative.

func (VideoContent)MarshalJSON

func (sVideoContent) MarshalJSON() ([]byte,error)

typeVideoMetadata

type VideoMetadata struct {// Duration: The duration of the ad. Can be used to filter the response of the// creatives.list method.Durationstring `json:"duration,omitempty"`// IsValidVast: Is this a valid VAST ad? Can be used to filter the response of// the creatives.list method.IsValidVastbool `json:"isValidVast,omitempty"`// IsVpaid: Is this a VPAID ad? Can be used to filter the response of the// creatives.list method.IsVpaidbool `json:"isVpaid,omitempty"`// MediaFiles: The list of all media files declared in the VAST. If there are// multiple VASTs in a wrapper chain, this includes the media files from the// deepest one in the chain.MediaFiles []*MediaFile `json:"mediaFiles,omitempty"`// SkipOffset: The minimum duration that the user has to watch before being// able to skip this ad. If the field is not set, the ad is not skippable. If// the field is set, the ad is skippable. Can be used to filter the response of// the creatives.list method.SkipOffsetstring `json:"skipOffset,omitempty"`// VastVersion: The maximum VAST version across all wrapped VAST documents. Can// be used to filter the response of the creatives.list method.//// Possible values://   "VAST_VERSION_UNSPECIFIED" - Default value that should never be used.//   "VAST_VERSION_1_0" - VAST 1.0//   "VAST_VERSION_2_0" - VAST 2.0//   "VAST_VERSION_3_0" - VAST 3.0//   "VAST_VERSION_4_0" - VAST 4.0VastVersionstring `json:"vastVersion,omitempty"`// ForceSendFields is a list of field names (e.g. "Duration") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Duration") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

VideoMetadata: Video metadata for a creative.

func (VideoMetadata)MarshalJSON

func (sVideoMetadata) MarshalJSON() ([]byte,error)

typeWatchCreativesRequest

type WatchCreativesRequest struct {}

WatchCreativesRequest: A request to receive push notifications when any ofthe creatives belonging to the bidder changes status.

typeWatchCreativesResponse

type WatchCreativesResponse struct {// Subscription: The Pub/Sub subscription that can be used to pull creative// status notifications. This would be of the format// `projects/{project_id}/subscriptions/{subscription_id}`. Subscription is// created with pull delivery. All service accounts belonging to the bidder// will have read access to this subscription. Subscriptions that are inactive// for more than 90 days will be disabled. Use watchCreatives to re-enable the// subscription.Subscriptionstring `json:"subscription,omitempty"`// Topic: The Pub/Sub topic that will be used to publish creative serving// status notifications. This would be of the format// `projects/{project_id}/topics/{topic_id}`.Topicstring `json:"topic,omitempty"`// ServerResponse contains the HTTP response code and headers from the server.googleapi.ServerResponse `json:"-"`// ForceSendFields is a list of field names (e.g. "Subscription") to// unconditionally include in API requests. By default, fields with empty or// default values are omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more// details.ForceSendFields []string `json:"-"`// NullFields is a list of field names (e.g. "Subscription") to include in API// requests with the JSON null value. By default, fields with empty values are// omitted from API requests. See//https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.NullFields []string `json:"-"`}

WatchCreativesResponse: A response for the request to receive pushnotification when a bidder's creatives change status.

func (WatchCreativesResponse)MarshalJSON

func (sWatchCreativesResponse) MarshalJSON() ([]byte,error)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f orF : Jump to
y orY : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic.Learn more.

[8]ページ先頭

©2009-2025 Movatter.jp