名前の階層
Search Ads 360 Reporting API で使用されるリソース名は階層的で、検索広告 360 内のエンティティの編成を反映します。ほぼすべてのリソースは Customer
リソースのサブリソースであり、ほぼすべての API 呼び出しで、特定の検索広告 360 アカウントをターゲットにしなければならないという事実が反映されています。たとえば、キャンペーン、広告グループ、広告、キーワードはすべて、ルート顧客リソースのサブリソースです。
リソース | リソース名 |
---|---|
顧客 | customers/1234567890
|
キャンペーン | customers/1234567890/campaigns/8765432109
|
AdGroup | customers/1234567890/adGroups/54321098765
|
AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
リソース ID
Search Ads 360 Reporting API のエンティティ(顧客、キャンペーンなど)は、API 全体でリソース名で参照されます。ただし、リソース名自体に、階層内の各オブジェクトを識別する一意の数値リソース ID が付与されている場合があります。このような場合は、リソース名を解析してこれらのリソース ID を抽出し、新しいリソース ID を作成すると便利です。
たとえば、前のテーブルの AdGroupAd
リソース名を調べます。
customers/1234567890/adGroupAds/54321098765~2109876543210
これは、次のように個々のリソース ID(コレクション ID で区切られたもの)に分類できます。
リソース名のコンポーネント | |||||||
---|---|---|---|---|---|---|---|
リソース ID |
|
||||||
コレクション ID |
|
個々の ID を解析することで、広告グループ広告の顧客(customers/1234567890
)またはその広告グループ(customers/1234567890/adGroupAds/54321098765
)を参照するための新しいリソース名を取得できます。