Method: accounts.payments.list

Lists all the payments available for an account.

HTTP request

GET https://adsense.googleapis.com/v2/{parent=accounts/*}/payments

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The account which owns the collection of payments. Format: accounts/{account}

Request body

The request body must be empty.

Response body

Response definition for the payments list rpc.

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

JSON representation
{
  "payments": [
    {
      object (Payment)
    }
  ]
}
Fields
payments[]

object (Payment)

The payments returned in this list response.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/adsense
  • https://www.googleapis.com/auth/adsense.readonly

Payment

Representation of an unpaid or paid payment.

See Payment timelines for AdSense for more information about payments and the YouTube homepage and payments account article for information about dedicated payments accounts for YouTube.

JSON representation
{
  "name": string,
  "date": {
    object (Date)
  },
  "amount": string
}
Fields
name

string

Output only. Resource name of the payment. Format:

  • accounts/{account}/payments/unpaid for unpaid (current) AdSense earnings.
  • accounts/{account}/payments/youtube-unpaid for unpaid (current) YouTube earnings.
  • accounts/{account}/payments/yyyy-MM-dd for paid AdSense earnings.
  • accounts/{account}/payments/youtube-yyyy-MM-dd for paid YouTube earnings.
date

object (Date)

Output only. For paid earnings, the date that the payment was credited. For unpaid earnings, this field is empty.

Payment dates are always returned in the billing timezone (America/Los_Angeles).

amount

string

Output only. The amount of unpaid or paid earnings, as a formatted string, including the currency. E.g. "¥1,235 JPY", "$1,234.57", "£87.65".