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

ChangeLogs: list

変更ログのリストを取得します。このメソッドはページングをサポートします。実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名 説明
パス パラメータ
profileId long このリクエストに関連付けられるユーザー プロフィール ID。
省略可能なクエリ パラメータ
action string 指定したアクションを持つ変更ログのみを選択します。

有効な値は次のとおりです。
  • "ACTION_ADD"
  • "ACTION_ASSIGN"
  • "ACTION_ASSOCIATE"
  • "ACTION_CREATE"
  • "ACTION_DELETE"
  • "ACTION_DISABLE"
  • "ACTION_EMAIL_TAGS"
  • "ACTION_ENABLE"
  • "ACTION_LINK"
  • "ACTION_MARK_AS_DEFAULT"
  • "ACTION_PUSH"
  • "ACTION_REMOVE"
  • "ACTION_SEND"
  • "ACTION_SHARE"
  • "ACTION_UNASSIGN"
  • "ACTION_UNLINK"
  • "ACTION_UPDATE"
ids long これらの ID を持つ変更ログのみを選択します。
maxChangeTime string 指定した maxChangeTime より前の変更時間を持つ変更ログのみを選択します。RFC3339 形式の日時文字列で時間を指定する必要があります。たとえば、「アメリカ / ニューヨーク」タイムゾーンの 2015 年 7 月 18 日午後 10 時 54 分の場合、形式は "2015-07-18T22:54:00-04:00" です。つまり、年、月、日、文字 T、時間(24 時制)、分、秒、タイムゾーンのオフセットです。
maxResults integer 表示する結果の最大数。設定可能な値は 01000 です。デフォルトは 1000 です。
minChangeTime string 指定した minChangeTime より後の変更時間を持つ変更ログのみを選択します。RFC3339 形式の日時文字列で時間を指定する必要があります。たとえば、「アメリカ / ニューヨーク」タイムゾーンの 2015 年 7 月 18 日午後 10 時 54 分の場合、形式は「2015-07-18T22:54:00-04:00」です。つまり、年、月、日、文字 T、時間(24 時制)、分、秒、タイムゾーンのオフセットです。
objectIds long これらのオブジェクト ID を持つ変更ログのみを選択します。
objectType string 指定したオブジェクト タイプを持つ変更ログのみを選択します。

有効な値は次のとおりです。
  • "OBJECT_ACCOUNT"
  • "OBJECT_ACCOUNT_BILLING_FEATURE"
  • "OBJECT_AD"
  • "OBJECT_ADVERTISER"
  • "OBJECT_ADVERTISER_GROUP"
  • "OBJECT_BILLING_ACCOUNT_GROUP"
  • "OBJECT_BILLING_FEATURE"
  • "OBJECT_BILLING_MINIMUM_FEE"
  • "OBJECT_BILLING_PROFILE"
  • "OBJECT_CAMPAIGN"
  • "OBJECT_CONTENT_CATEGORY"
  • "OBJECT_CREATIVE"
  • "OBJECT_CREATIVE_ASSET"
  • "OBJECT_CREATIVE_BUNDLE"
  • "OBJECT_CREATIVE_FIELD"
  • "OBJECT_CREATIVE_GROUP"
  • "OBJECT_DFA_SITE"
  • "OBJECT_EVENT_TAG"
  • "OBJECT_FLOODLIGHT_ACTIVITY_GROUP"
  • "OBJECT_FLOODLIGHT_ACTVITY"
  • "OBJECT_FLOODLIGHT_CONFIGURATION"
  • "OBJECT_FLOODLIGHT_DV360_LINK"
  • "OBJECT_INSTREAM_CREATIVE"
  • "OBJECT_LANDING_PAGE"
  • "OBJECT_MEDIA_ORDER"
  • "OBJECT_PLACEMENT"
  • "OBJECT_PLACEMENT_STRATEGY"
  • "OBJECT_PLAYSTORE_LINK"
  • "OBJECT_PROVIDED_LIST_CLIENT"
  • "OBJECT_RATE_CARD"
  • "OBJECT_REMARKETING_LIST"
  • "OBJECT_RICHMEDIA_CREATIVE"
  • "OBJECT_SD_SITE"
  • "OBJECT_SEARCH_LIFT_STUDY"
  • "OBJECT_SIZE"
  • "OBJECT_SUBACCOUNT"
  • "OBJECT_TARGETING_TEMPLATE"
  • "OBJECT_USER_PROFILE"
  • "OBJECT_USER_PROFILE_FILTER"
  • "OBJECT_USER_ROLE"
pageToken string 前の結果ページの nextPageToken の値。
searchString string オブジェクト ID、ユーザー名、古い値または新しい値が検索文字列と一致する変更ログのみを選択します。
userProfileIds long これらのユーザー プロフィール ID を持つ変更ログのみを選択します。

認証

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

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

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

リクエストの本文

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

レスポンス

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

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

実習

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