Method: advertisers.invoices.list

特定の月に広告主に対して送信された請求書を一覧表示します。

請求書レベルが「パートナー」の請求プロファイルで生成された請求書は、この方法では取得できません。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。請求書を一覧表示する広告主の ID。

クエリ パラメータ

パラメータ
issueMonth

string

請求書を一覧表示する月。設定されていない場合、リクエストで前月の請求書が取得されます。

YYYYMM の形式で指定してください。
loiSapinInvoiceType

enum (LoiSapinInvoiceType)

Loi Sapin の広告主に対して取得する請求書の種類を選択します。

Loi Sapin の対象となる広告主様にのみ適用されます。それ以外の場合は無視されます。
pageSize

integer

リクエストされたページサイズです。 1～200 の範囲で指定してください。指定しない場合、デフォルトの 100 が使用されます。無効な値が指定されている場合は、エラーコード INVALID_ARGUMENT を返します。
pageToken

string

サーバーが返す必要がある結果のページを特定するトークンです。 通常、これは invoices.list メソッドの前の呼び出しから返された nextPageToken の値です。指定しない場合、結果の最初のページが返されます。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "invoices": [
    {
      object (Invoice)
    }
  ],
  "nextPageToken": string
}
フィールド
invoices[]

object (Invoice)

請求書のリスト。

空の場合は、このリストは表示されません。
nextPageToken

string

結果の次のページを取得するためのトークン。 この値を次の invoices.list メソッド呼び出しの pageToken フィールドで渡して、結果の次ページを取得します。

返される invoices がない場合、このトークンは存在しません。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。

LoiSapinInvoiceType

サパン法の適用対象となる広告主様が受け取る可能性がある請求書の種類。

列挙型
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED 値が指定されていません。
LOI_SAPIN_INVOICE_TYPE_MEDIA メディア費用を含む請求書。
LOI_SAPIN_INVOICE_TYPE_PLATFORM プラットフォーム手数料が記載された請求書。

請求書

1 つの請求書。

JSON 表現 
{
  "name": string,
  "invoiceId": string,
  "displayName": string,
  "paymentsProfileId": string,
  "paymentsAccountId": string,
  "issueDate": {
    object (Date)
  },
  "dueDate": {
    object (Date)
  },
  "serviceDateRange": {
    object (DateRange)
  },
  "currencyCode": string,
  "subtotalAmountMicros": string,
  "totalTaxAmountMicros": string,
  "totalAmountMicros": string,
  "purchaseOrderNumber": string,
  "budgetInvoiceGroupingId": string,
  "invoiceType": enum (InvoiceType),
  "correctedInvoiceId": string,
  "replacedInvoiceIds": [
    string
  ],
  "pdfUrl": string,
  "budgetSummaries": [
    {
      object (BudgetSummary)
    }
  ],
  "nonBudgetMicros": string
}
フィールド
name

string

請求書のリソース名。
invoiceId

string

請求書の一意の ID。
displayName

string

請求書の表示名。
paymentsProfileId

string

請求書が属するお支払いプロファイルの ID。

請求書の PDF には Billing ID と表示されます。
paymentsAccountId

string

請求書が属するお支払いアカウントの ID。

請求書の PDF には Billing Account Number と表示されます。
issueDate

object (Date)

請求書の発行日。
dueDate

object (Date)

請求書の支払い期限。
serviceDateRange

object (DateRange)

この請求書の対象となるサービスの開始日と終了日。
currencyCode

string

請求書で使用する通貨（ISO 4217 形式）。
subtotalAmountMicros

string (int64 format)

請求書の通貨のマイクロ単位で表した、税抜き小計の金額。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。
totalTaxAmountMicros

string (int64 format)

請求書のすべての税金の合計（請求書の通貨のマイクロ単位）。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。
totalAmountMicros

string (int64 format)

請求書の合計金額（請求書の通貨のマイクロ単位）。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。
purchaseOrderNumber

string

請求書に関連付けられている注文書番号。
budgetInvoiceGroupingId

string

この請求書の予算グループ ID。

このフィールドは、対応する請求プロファイルの請求書レベルが [予算請求書グループ ID] に設定されている場合にのみ設定されます。
invoiceType

enum (InvoiceType)

請求書ドキュメントのタイプ。
correctedInvoiceId

string

この請求書で調整される元の請求書の ID（該当する場合）。

請求書の PDF には Reference invoice number と表示される場合があります。

replacedInvoiceIds が設定されている場合、このフィールドは空になります。
replacedInvoiceIds[]

string

この請求書によってキャンセルされる元の請求書の ID（該当する場合）。複数の請求書が 1 通の請求書に統合されている場合は、複数の請求書が表示されることがあります。

請求書の PDF には Replaced invoice numbers と表示される場合があります。

correctedInvoiceId が設定されている場合、このフィールドは空になります。
pdfUrl

string

請求書の PDF 版をダウンロードするための URL。

この URL はユーザー固有であり、アクセスするには有効な OAuth 2.0 アクセス トークンが必要です。アクセス トークンは Authorization: Bearer HTTP ヘッダーで指定し、次のいずれかのスコープで承認されている必要があります。

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

この URL は、この請求書オブジェクトの取得後 7 日間、またはこの請求書が再度取得されるまで有効です。
budgetSummaries[]

object (BudgetSummary)

この請求書に関連付けられている各予算の概要情報のリスト。

このフィールドは、対応する請求プロファイルの請求書の詳細レベルが [予算レベルの PO] に設定されている場合にのみ設定されます。
nonBudgetMicros

string (int64 format)

特定の予算に関連付けられていない費用または調整額の合計（請求書の通貨のマイクロ単位）。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。

InvoiceType

請求書の種類。

列挙型
INVOICE_TYPE_UNSPECIFIED このバージョンでは指定されていないか不明です。
INVOICE_TYPE_CREDIT 請求書の金額がマイナスである。
INVOICE_TYPE_INVOICE 請求書の金額が正である。

BudgetSummary

個々のキャンペーン予算の概要情報。

JSON 表現 
{
  "externalBudgetId": string,
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "preTaxAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}
フィールド
externalBudgetId

string

キャンペーン予算の externalBudgetId に対応します。キャンペーン予算で値が設定されていない場合、このフィールドは空白になります。
prismaCpeCode

object (PrismaCpeCode)

Mediaocean Prisma ツールの関連するクライアント コード、プロダクト コード、見積もりコード。

externalBudgetSource が EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN のキャンペーン予算にのみ適用されます。
preTaxAmountMicros

string (int64 format)

この予算で発生した請求額の合計（税抜き）。請求書の通貨のマイクロ単位で表示されます。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。
taxAmountMicros

string (int64 format)

この予算の請求に適用される税額（請求書の通貨のマイクロ単位）。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。
totalAmountMicros

string (int64 format)

この予算で発生した請求の合計額（税金を含む）を、請求書の通貨のマイクロ単位で表示します。

たとえば、currencyCode が USD の場合、1000000 は 1 米ドルを表します。