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 表示する結果の最大数。有効な値は 0 以上 1000 以下です(デフォルト: 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 を使用し、ライブデータに対してこのメソッドを呼び出して、レスポンスを確認してみましょう。