Method: advertisers.invoices.lookupInvoiceCurrency

  • This endpoint retrieves the invoice currency used by a specified advertiser for a given month using an HTTP GET request.

  • The request requires an advertiserId as a path parameter and optionally accepts an invoiceMonth in YYYYMM format as a query parameter.

  • If successful, the response returns the currency code in ISO 4217 format within a JSON object.

  • To use this endpoint, you need authorization with either the https://www.googleapis.com/auth/display-video or https://www.googleapis.com/auth/display-video-mediaplanning OAuth scope.

Retrieves the invoice currency used by an advertiser in a given month.

HTTP request

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/invoices:lookupInvoiceCurrency

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
advertiserId

string (int64 format)

Required. The ID of the advertiser to lookup currency for.

Query parameters

Parameters
invoiceMonth

string

Month for which the currency is needed. If not set, the request will return existing currency settings for the advertiser.

Must be in the format YYYYMM.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "currencyCode": string
}
Fields
currencyCode

string

Currency used by the advertiser in ISO 4217 format.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/display-video
  • https://www.googleapis.com/auth/display-video-mediaplanning

For more information, see the OAuth 2.0 Overview.