このページは Cloud Translation API によって翻訳されました。

リリースノート

このページには AdSense Management API のリリースノートが掲載されています。

バージョン 2

このバージョンでは、サポートが終了した機能を削除し、AdSense Management API を現在の Google API 標準に合わせるために、次の変更を行いました。このバージョンは、Google API のバージョニングスキームに基づき、個別のマイナーバージョンでリリースされる新機能ではなく、追加機能（下位互換性のある）機能を含むように順次更新されます。

2024-04-03

PolicyIssues

アカウントの現在のポリシー違反と警告についてレポートするための新しいコレクションを追加しました。

2023-06-19

支払い

payments.list は、プレミアムパブリッシャーの支払いに関する詳細を返すようになりました。

2023-06-13

Google アナリティクス 4 プロパティのレポートについて

FUNNEL_REQUESTS、FUNNEL_IMPRESSIONS、FUNNEL_CLICKS、FUNNEL_RPM の指標を追加しました。これにより、広告ユニット以外（関連する検索ユニットなど）のパフォーマンスに関する情報を確認できます。

2023-03-30

Google アナリティクス 4 プロパティのレポートについて

PAGE_URL ディメンションを追加しました。これにより、指標をページの URL 別に分類できます（注意点があります。ページ URL の内訳をご覧ください）。

2022-09-21

AdUnits

create メソッドと patch メソッドを追加しました。これらの方法を使用できるのは、プラットフォーム向け AdSense サービスが有効になっているプロジェクトのみです。

CustomChannels

create、patch、update の各メソッドを追加しました。これらの方法を使用できるのは、プラットフォーム向け AdSense サービスが有効になっているプロジェクトのみです。
リソースにアクティブフィールドを追加しました。

アカウント

getAdblockRecoveryTag メソッドが追加されました。

2022-08-25

Google アナリティクス 4 プロパティのレポートについて

「HOSTED_AD_CLIENT_ID」ディメンションを追加しました。これにより、ホストパブリッシャーとプラットフォームパブリッシャーが、パブリッシャーのアカウント（ホストパブリッシャー）とサブアカウント（プラットフォームパブリッシャー）別に指標を分類できるようになりました。

2022-05-03

AdClient

get メソッドを追加しました。

Google アナリティクス 4 プロパティのレポートについて

getSaved メソッドを追加しました。

UrlChannels

get メソッドを追加しました。

2022-03-31

アカウント

無効なアカウントは、state フィールドがアカウントの状態を示すとともに、API から返されるようになりました。

AdClient

上記のアカウントの変更と同様に、無効な広告クライアントが API から返されるようになりました。state フィールドは広告クライアントの状態を示します。

2022-02-24

お支払い

リソース名の形式が拡張され、YouTube の収益用の個別のリソースがサポートされるようになりました。この変更は、YouTube クリエイター向けの AdSense 改善を段階的に展開する前の段階です。YouTube の収益は、それぞれのお支払いアカウントに分けられます。YouTube のお支払い情報は、YouTube での収益専用のお支払いアカウントをお持ちの場合は、お支払い方法のリストでも確認できます。YouTube の収益は、次のリソース名形式になります。
- accounts/{account}/payments/youtube-unpaid は、未払いの（現在の）YouTube 収益のお支払いです。
- accounts/{account}/payments/youtube-yyyy-MM-dd（YouTube の有料収益）
注: AdSense の収益のリソース名に変更はありません。
- accounts/{account}/payments/未払いの（現在の）AdSense 収益のお支払い。
- accounts/{account}/payments/yyyy-MM-dd（AdSense の有料収益の場合）

2021-06-30

報告

サイト上のユーザーへの広告表示方法（ページはめ込み、全画面など）を示すディメンション AD_FORMAT_NAME と AD_FORMAT_CODE を追加しました。v1.4 には、名前が同じでメンバーが異なるディメンション（非推奨）がありました。v2 で追加された 2 つのディメンションは、v1.4 にあったディメンションとは異なります。

2021-04-19（初回リリース）

全般

v1.4 の非推奨のメソッドはすべて削除されました。これには、accountId を必要としないリソースメソッドも含まれます。v2 では、accountId は parent フィールドで指定します。
Google API 標準に従い、リソースは name フィールドで識別されるようになりました。たとえば、Manufacturer の名前は accounts/{accountId}/adclients/{adClientId} のようになります。また、v1.4 ではリソース ID がレポートディメンションとして使用されていましたが、v2 では、その値が複数のリソースの reporting_dimension_id フィールドから使用できるようになりました。
kind フィールドがすべてのリソースから削除されました。

アカウント

name フィールドが display_name に変更されました。
timezone フィールドが文字列から google.type.TimeZone に変更されました。
creation_time フィールド（int64 タイプ）が create_time（google.protobuf.Timestamp タイプ）に変更されました。
新しいアカウントの登録プロセスの一環として完了する必要がある未処理のタスクのリストを示す pending_tasks フィールドを追加しました。たとえば、お支払い情報や電話確認に関連するタスクがあります。
sub_accounts フィールドが削除されました。v2 では、listChildAccounts カスタムメソッドを使用して同様の機能を実現できます。v2 では、listChildAccounts を再帰的に呼び出すことで、子アカウントツリー全体を生成できます。

AdClient

arc_opt_in フィールドは、すでに AdSense 管理画面から削除されているため、削除されました。
supports_reporting フィールドは reporting_dimension_id フィールドに置き換えられます。これは AD_CLIENT_ID レポートディメンションで使用される広告クライアントの一意の ID を表します。reporting_dimension_id が空の場合、Ariba はレポートをサポートしていません。

AdUnit

status フィールドの名前が state に変更されました。また、ACTIVE 状態では、過去 7 日間にこの広告ユニットでアクティビティがあったかどうかはわかりません。v2 では、広告ユニットがユーザーによって有効化され、広告を配信できることを意味します。
code フィールドが削除されました。この値は引き続き name フィールドの末尾（最後のスラッシュの後）にあります。
contentAdsSettings.backupOption フィールドが削除されました。
type フィールドの値が TYPE_UNSPECIFIED、DISPLAY、FEED、ARTICLE、MATCHED_CONTENT、LINK に制限されています。
AdSense 管理画面ですでに削除されている他のフィールド（custom_style、saved_style_id、 mobile_content_ads_settings、feed_ads_settings）も削除されます。

アラート

delete メソッドが削除されました。
is_dismissible フィールドが削除されました。
locale フィールドの名前が language_code に変更されました。

CustomChannel

code フィールドが削除されました。この値は引き続き name フィールドの末尾（最後のスラッシュの後）にあります。
targeting_info フィールドは、すでに AdSense 管理画面から削除されているため、削除されました。

お支払い

payment_date フィールドの名前が date に変更され、string 型から google.type.Date 型に変更されました。
payment_amount フィールドと payment_amount_currency_code フィールドは、単一の payment フィールドに統合されました（例:「1,235 円」、「$1,234.57」、「£87.65」）。

報告

v2 では、AdSense Management API のレポートデータが AdSense 管理画面と一致するようになりました。つまり、AdMob と YouTube のプロパティはサポートされなくなりました。また、API でサポートされるのは 3 年前までのレポートデータのみです。
Metadata.dimensions リソースと Metadata.metrics リソースが削除されました。
CSV バージョンのレポートを生成する新しいメソッドが追加され、v1.4 のクエリパラメータに代わりました。注: 圧縮については、HTTP ヘッダー「Accept-Encoding: gzip」を引き続き使用できます。
アドホックレポートの生成で、一部のフィールドが変更されました。
- account_id フィールドの名前が account に変更されました。
- dimension フィールドの名前が dimensions に変更されました。
- metric フィールドの名前が metrics に変更されました。
- filter フィールドの名前が filters に変更されました。
- sort フィールドの名前が order_by に変更されました。
- locale フィールドの名前が language_code に変更されました。
- currency フィールドの名前が currency_code に変更されました。
- date_range を使用して、いくつかの一般的な範囲を指定できるようになりました（例:TODAY、YESTERDAY、MONTH_TO_DATE、YEAR_TO_DATE、LAST_7_DAYS、LAST_30_DAYS）を使用するか、date_range を CUSTOM に設定して start_date と end_date を指定できます。
- start_date フィールドと end_date フィールドが string 型から google.type.Date 型に変更されました。注: そのため、相対的な日付のキーワード（「today-6d」）はサポートされなくなりました。
- ブール値フィールド use_timezone_reporting が reporting_time_zone に置き換えられました。これは、ACCOUNT_TIME_ZONE または GOOGLE_TIME_ZONE（PST/PDT）のいずれかの値を取ることができます。v2 のデフォルトは ACCOUNT_TIME_ZONE で、v1.4 のデフォルトとは異なります。
- start_index フィールドが削除されました。
- max_results フィールドの名前が limit に変更されました。
保存済みレポートの生成時に、一部のフィールドが変更されました。
- 日付フィールド（date_range、start_date、end_date、reporting_time_zone）を追加しました。
- currency_code フィールドを追加しました。
- locale フィールドの名前が language_code に変更されました。
- start_index フィールドが削除されました。
- max_results フィールドが削除されました。

SavedAdStyle

SavedAdStyle はすでに AdSense 管理画面から削除されているため、削除されました。

サイト

お客様が AdSense アカウントに追加したウェブサイトに関するデータを取得するために、Sites が追加されました。
state フィールドは、サイトが REQUIRES_REVIEW、GETTING_READY、READY、NEEDS_ATTENTION のいずれの状態であるかを表します。
auto_ads_enabled フィールドは、特定のサイトで自動広告が有効になっているかどうかを表すブール値です。