Sdf: download

SDF 形式でエンティティを取得します。 実習をご覧ください。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/doubleclickbidmanager/v1.1/sdf/download

承認

このリクエストには、次のスコープによる認証が必要です。

スコープ
https://www.googleapis.com/auth/doubleclickbidmanager

詳細については、認証と認可のページをご覧ください。

リクエスト本文

リクエストの本文には、以下の構造を使用してデータを指定してください。

{
  "fileTypes": [
    string
  ],
  "filterType": string,
  "filterIds": [
    long
  ],
  "version": string
}
プロパティ名 説明 メモ
fileTypes[] list 返されるファイル形式。INVENTORY_SOURCE がリクエストされている場合は、他のファイル形式はリクエストできません。

指定できる値は次のとおりです。
  • AD
  • "AD_GROUP"
  • "CAMPAIGN"
  • "INSERTION_ORDER"
  • "INVENTORY_SOURCE"
  • LINE_ITEM
filterType string 取得するエンティティをフィルタするために使用するフィルタタイプ。PARTNER_ID と INVENTORY_SOURCE_ID は、広告枠ソースをダウンロードする場合にのみ使用できます。

有効な値は次のとおりです。
  • "ADVERTISER_ID"
  • "CAMPAIGN_ID"
  • "INSERTION_ORDER_ID"
  • "INVENTORY_SOURCE_ID"
  • "LINE_ITEM_ID"
  • PARTNER_ID
filterIds[] list 指定したフィルタタイプの ID。取得するエンティティをフィルタするために使用されます。ID を少なくとも 1 つ指定する必要があります。ADVERTISER_ID フィルタタイプで使用できる ID は 1 つのみです。INSERTION_ORDER_ID または LINE_ITEM_ID フィルタタイプの場合、ID はすべて同じ広告主のものである必要があります。
version string エンティティが返される SDF のバージョン(列名、型、順序)。デフォルトは 5.3 です。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "campaigns": string,
  "insertionOrders": string,
  "lineItems": string,
  "adGroups": string,
  "ads": string,
  "inventorySources": string
}
プロパティ名 説明 メモ
insertionOrders string SDF 形式で取得された広告掲載オーダー。
lineItems string 取得済みの広告申込情報(SDF 形式)。
adGroups string SDF 形式で取得された広告グループ
ads string SDF フォーマットで取得した広告。
campaigns string 取得したキャンペーン(SDF 形式)。
inventorySources string

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。 または、 スタンドアロン エクスプローラをご覧ください。