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 がリクエストされている場合は、他のファイル形式はリクエストできません。 指定できる値は次のとおりです。
|
|
filterType |
string |
取得するエンティティをフィルタするために使用するフィルタタイプ。PARTNER_ID と INVENTORY_SOURCE_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 を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。 または、 スタンドアロン エクスプローラをご覧ください。