リソース名

名前の階層

Google Ads API で使用されるリソース名は階層的で、 Google 広告内のエンティティの構成です。ほぼすべてのリソースがサブリソース （Customer） これは、ほぼすべての API 呼び出しで特定の API をターゲットにしなければならないという事実を反映しています。 関連付けられます例: キャンペーン、広告グループ、広告、キーワード ルート顧客リソースのすべてのサブリソースです

リソース リソース名
お客様 customers/1234567890
キャンペーン customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

リソース ID

Google 広告のエンティティ（顧客、キャンペーンなど）は、リソースによって参照されます。 使用できます。ただし、このリソースは 名前自体には、一意の数値リソースを持つことができます。 ID を使用して識別されます。 自動的に作成されます。そのような場合は、 して、これらのリソース ID を抽出し、新しいリソース ID を作成します。

たとえば、前のテーブルの AdGroupAd リソース名を調べます。

customers/1234567890/adGroupAds/54321098765~2109876543210

これは、個別のリソース ID（ コレクション ID） 次のとおりです。

リソース名のコンポーネント
リソース ID
お客様 ID:
"1234567890"
広告グループ ID:
"54321098765"
広告グループの広告 ID:
"2109876543210"
コレクション ID
"customers"
"adGroupAds"

個々の ID を解析することで、参照する新しいリソース名を導き出せる 広告グループの広告のユーザー（customers/1234567890）またはその広告グループ （customers/1234567890/adGroupAds/54321098765）。

共有オブジェクトの識別子

API のほとんどのオブジェクトは、1 つの Google 広告に関連付けられています。 提供します。ただし、一部のオブジェクト タイプは 複数のアカウントで利用できます。具体的には、除外キーワード、 リストまたはクロスアカウント 既存のコンバージョンアクションを 通常はマネージャーが作成し、多くのクライアント アカウントと共有する。

このようなオブジェクトのリソース名は、 API 呼び出しの送信先アカウント。

例: クロスアカウント コンバージョン アクション

クライアント センター（MCC）アカウント 987-654-3210 がクロスアカウントを共有しているとします いずれかのクライアント アカウント（123-456-7890）とコンバージョン アクションを関連付けた場合:

リソース名とアカウント階層の関係を示す図。

MCC アカウントに API 呼び出しを行って、コンバージョンの更新などを行う アクションのルックバック ウィンドウは、リソース名を使用して共有オブジェクトを参照します。 customers/9876543210/conversionActions/257733534。

クライアント アカウントに API 呼び出しを行い、共有 コンバージョン アクションがリソース名で参照します。 customers/1234567890/conversionActions/257733534。

基になるコンバージョン アクションと同じですが、リソース名は相対的なものです アカウントへのアクセスに使用されます。

前へ
概要
次へ
サービス メソッド