Campaign Manager 360 API v3.3 はサポートが終了し、2021 年 6 月 30 日に廃止されます。この日までに、すべてのユーザーが新しいバージョンの API に移行する必要があります。

Creatives: list

クリエイティブのリストを取得します。結果をフィルタできます。このメソッドはページングをサポートします。実習をご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/creatives

パラメータ

パラメータ名 説明
パス パラメータ
profileId long このリクエストに関連付けられるユーザー プロフィール ID。
省略可能なクエリ パラメータ
active boolean 有効なクリエイティブのみを選択します。有効なクリエイティブと無効なクリエイティブを選択するには、空白のままにします。
advertiserId long この広告主 ID を持つクリエイティブのみを選択します。
archived boolean アーカイブ済みのクリエイティブのみを選択します。アーカイブ済みのクリエイティブとアーカイブされていないクリエイティブを選択するには、空白のままにします。
campaignId long このキャンペーン ID を持つクリエイティブのみを選択します。
companionCreativeIds long これらのコンパニオン ID を持つインストリーム動画クリエイティブのみを選択します。
creativeFieldIds long これらのクリエイティブ フィールド ID を持つクリエイティブのみを選択します。
ids long これらの ID を持つクリエイティブのみを選択します。
maxResults integer 表示する結果の最大数。設定可能な値は 01000 です。デフォルトは 1000 です。
pageToken string 前の結果ページの nextPageToken の値。
renderingIds long これらのレンダリング ID を持つクリエイティブのみを選択します。
searchString string 名前または ID により、オブジェクトを検索できます。ワイルドカード(*)を使用できます。たとえば、"creative*2015" を検索すると、"creative June 2015""creative April 2015"、または単に "creative 2015" のような名前を持つオブジェクトが返されます。また、ほとんどの検索では、検索文字列の前後に非明示的なワイルドカードが追加されます。たとえば、"creative" という検索文字列は、"my creative""creative 2015"、または単に "creative" という名前を持つオブジェクトに一致します。
sizeIds long これらのサイズ ID を持つクリエイティブのみを選択します。
sortField string 結果の並べ替え基準として使用するフィールド。

設定可能な値は次のとおりです。
  • "ID"(デフォルト)
  • "NAME"
sortOrder string 結果の並べ替え順序。

設定可能な値は次のとおりです。
  • "ASCENDING"(デフォルト)
  • DESCENDING
studioCreativeId long このスタジオ クリエイティブ ID に対応するクリエイティブのみを選択します。
types string これらのクリエイティブ タイプを持つクリエイティブのみを選択します。

有効な値は次のとおりです。
  • "BRAND_SAFE_DEFAULT_INSTREAM_VIDEO"
  • "CUSTOM_DISPLAY"
  • "CUSTOM_DISPLAY_INTERSTITIAL"
  • "DISPLAY"
  • "DISPLAY_IMAGE_GALLERY"
  • "DISPLAY_REDIRECT"
  • "FLASH_INPAGE"
  • "HTML5_BANNER"
  • "IMAGE"
  • "INSTREAM_AUDIO"
  • "INSTREAM_VIDEO"
  • "INSTREAM_VIDEO_REDIRECT"
  • "INTERNAL_REDIRECT"
  • "INTERSTITIAL_INTERNAL_REDIRECT"
  • "RICH_MEDIA_DISPLAY_BANNER"
  • "RICH_MEDIA_DISPLAY_EXPANDING"
  • "RICH_MEDIA_DISPLAY_INTERSTITIAL"
  • "RICH_MEDIA_DISPLAY_MULTI_FLOATING_INTERSTITIAL"
  • "RICH_MEDIA_IM_EXPAND"
  • "RICH_MEDIA_INPAGE_FLOATING"
  • "RICH_MEDIA_MOBILE_IN_APP"
  • "RICH_MEDIA_PEEL_DOWN"
  • "TRACKING_TEXT"
  • "VPAID_LINEAR_VIDEO"
  • "VPAID_NON_LINEAR_VIDEO"

認証

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

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

詳しくは、認証と認可のページをご覧ください。

リクエストの本体

このメソッドでは、リクエストの本体を指定しません。

レスポンス

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

{
  "kind": "dfareporting#creativesListResponse",
  "nextPageToken": string,
  "creatives": [
    creatives Resource
  ]
}
プロパティ名 説明 メモ
kind string リソースの種類を識別します。値: 固定文字列 "dfareporting#creativesListResponse"
nextPageToken string 次のリストに移動する操作に使用されるページ分けトークン。
creatives[] list クリエイティブのコレクション。

試してみる

以下の API Explorer を使用し、ライブデータに対してこのメソッドを呼び出して、レスポンスを確認してみましょう。