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