検索広告 360 のアカウント階層とリソースの所有権
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
検索広告 360 リニューアル版の階層には、次の 3 種類のアカウントがあります。
マネージャー アカウント - 従来は「代理店アカウント」と呼ばれていました。これは、検索広告 360 アカウント階層の最上位で、下位レベルのサブマネージャー アカウントとクライアント アカウントの管理とレポート作成に使用されます。
サブマネージャー アカウント - 以前の「広告主アカウント」。サブマネージャー アカウントは、管理するクライアント アカウント全体の管理とレポート作成の単一ポイントとして機能します。
クライアント アカウント - 旧称「エンジン アカウント」。クライアント アカウントには、キャンペーン、広告グループなどの項目が含まれます。
詳しくは、検索広告 360 のアカウント階層をご覧ください。
検索広告 360 の各リソースは、MCC アカウント、サブマネージャー アカウント、クライアント アカウントのいずれかのレベルで所有されます。
リソースをクエリするには、所有者のアカウント レベル以上の認証が必要です。適切な所有者アカウント レベルで認証されたら、リクエストされたデータを所有するアカウントの特定の ID をクエリに含める必要があります。
たとえば、CustomColumn リソースはマネージャー アカウントまたはサブマネージャー アカウント単位で所有されますが、Campaign リソースはクライアント アカウント単位で所有されます。つまり、CustomColumn をクエリするには、MCC アカウントまたはサブマネージャー アカウント レベルで認証されている必要があります。また、リクエストされた CustomColumn を所有する MCC アカウントまたはサブマネージャー アカウントの ID をクエリで指定する必要があります。Campaign データをクエリするには、MCC アカウントまたはサブマネージャー アカウントの階層で認証を受けることができます。また、リクエストされたキャンペーン データを所有するクライアント アカウントの ID をクエリで指定する必要があります。
アカウントの階層構造について
Search Ads 360 Reporting API を使用してレポートを作成するには、まず、クエリする MCC アカウント、サブマネージャー アカウント、クライアント アカウント間の親子関係を特定して、アカウント階層を把握する必要があります。
マネージャー アカウントまたはサブマネージャー アカウントの下で管理されているお子様を特定する
MCC アカウントまたはサブマネージャー アカウントの子アカウントの構造を確認するには、検索広告 360 クエリ言語ステートメントを作成して、CustomerClient リソースのすべての直接子アカウントをクエリします。次に、直接の子アカウントごとに CustomerClient リソースに対して反復的にクエリを実行し、マネージャー アカウントまたはサブマネージャー アカウントに間接的にリンクされている子アカウントを返します。
アカウントのマネージャー（親）を特定する
お客様のアカウントの親を特定するには、CustomerManagerLink リソースをクエリします。
複数のアカウントレベルのデータを使用してレポートを作成する
複数のアカウント単位のデータを使ってレポートを作成しなければならない場合もあります。たとえば、データのほとんどをクライアント アカウント レベルの Campaign リソースから取得する場合でも、サブマネージャー アカウント レベルの CustomColumn リソースから補足データを取得する必要がある場合があります。
アカウントの異なるレベルで所有するリソース
BiddingStrategy などのリソースは、マネージャー アカウント、サブマネージャー アカウント、クライアント アカウントのレベルで所有できます。通常、これらのインスタンスでは、クライアント アカウントがリソースデータのさまざまなサブセットにアクセスできます。
Search Ads 360 Reporting API は、ほとんどのリソースの指標をクライアント アカウント レベルでのみ提供しますが、BiddingStrategy などの一部のリソースでは、マネージャー レベルとサブマネージャー レベルで指標を取得できます。
リソースの所有権
次の表に、検索広告 360 の各リソースのアカウント単位の所有権を示します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-29 UTC。
[null,null,["最終更新日 2025-08-29 UTC。"],[[["\u003cp\u003eSearch Ads 360 utilizes a three-tiered account hierarchy consisting of Manager, Sub-manager, and Client accounts for administration, reporting, and campaign management.\u003c/p\u003e\n"],["\u003cp\u003eTo query a resource, users need to authenticate at or above the resource's owner account level and specify the owning account's ID in their query.\u003c/p\u003e\n"],["\u003cp\u003eBuilding reports may require understanding parent-child relationships between accounts and utilizing data from multiple account levels.\u003c/p\u003e\n"],["\u003cp\u003eDifferent Search Ads 360 resources are owned at different account levels (Manager, Sub-manager, or Client) as outlined in the provided resource ownership table.\u003c/p\u003e\n"],["\u003cp\u003eSome resources, like BiddingStrategy, can be owned at multiple account levels, offering varying levels of access to resource data for client accounts.\u003c/p\u003e\n"]]],["Search Ads 360 uses a three-tiered account hierarchy: Manager, Sub-manager, and Client. To query resources, authenticate at or above the owner's account level and include the owner's ID in your query. Identify child accounts under a manager or sub-manager using the `CustomerClient` resource, and identify parent accounts using `CustomerManagerLink`. Reports often require data from multiple account levels. Resource ownership varies; for instance, `CustomColumn` is owned by Manager/Sub-manager, while `Campaign` is Client-owned.\n"],null,["# Search Ads 360 account hierarchy and resource ownership\n\nThere are three types of accounts in the new Search Ads 360 hierarchy:\n\n- Manager Account - previously called an \"agency account.\" This is the top\n level of the Search Ads 360 account hierarchy and is used for administration and\n reporting across the lower-level sub-manager and client accounts.\n\n- Sub-manager accounts - previously called \"advertiser accounts.\" Sub-manager\n accounts act as single points of administration and reporting across the client\n accounts that they manage.\n\n- Client accounts - previously called \"engine accounts.\" A client account\n contains the campaigns, ad groups, and other items.\n\nLearn more about the [Search Ads 360 account hierarchy](https://support.google.com/sa360/answer/9158072).\n\nEach Search Ads 360 resource is owned at either the manager, sub-manager or\nclient account level.\n\nTo query a resource you must be authenticated at the owner account level or\nhigher. Once you are authenticated at the appropriate owner account level, you\nmust include in your query the specific ID of the account that owns the\nrequested data.\n\nFor example, the [`CustomColumn`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.CustomColumn)\nresource is owned at the manager or sub-manager account level, while the [`Campaign`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaign)\nresource is owned at the client account level. This means that to query\n[`CustomColumn`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.CustomColumn)\nyou must be authenticated at the manager or sub-manager account level. You must\nalso specify in your query the ID of the manager or sub-manager account that\nowns the requested `CustomColumn`. To query [`Campaign`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaign)\ndata you may be authenticated at either the manager or sub-manager account\nlevel. In addition, you must specify in your query the ID of the client account\nthat owns the requested Campaign data.\n\nUnderstanding the account hierarchy\n-----------------------------------\n\nTo build reports using the Search Ads 360 Reporting API you must first\nunderstand the account hierarchy by identifying the parent-child relationships\nbetween the manager, sub-manager, and client accounts that you are querying.\n\n### Identify children under a manager or sub-manager account\n\nTo see the structure of the child accounts under a manager or sub-manager\naccount, build a Search Ads 360 Query Language statement to query all direct\nchild accounts from the [`CustomerClient`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#customerclient)\nresource. Then iteratively query the `CustomerClient` resource for each direct\nchild account to return the child accounts that are linked indirectly to the\nmanager or sub-manager account.\n\n### Identifying the manager (parent) of an account\n\nTo identify the parent of a customer account, query the [`CustomerManagerLink`](/search-ads/reporting/api/reference/fields/v0/customer_manager_link)\nresource.\n\nBuilding reports with data from multiple account levels\n-------------------------------------------------------\n\nIn some cases you will need to use data from multiple account levels to build a\nreport. For example you may get most of your data from the [`Campaign`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.Campaign)\nresource at the client account level, but also require supporting data from the\n[`CustomColumn`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.CustomColumn)\nresource at the sub-manager account level.\n\nResources owned at different account levels\n-------------------------------------------\n\nSome resources, such as [`BiddingStrategy`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#biddingstrategy),\ncan be owned at the manager, sub-manager and client account levels. In these\ninstances, the client accounts typically have access to different subsets of\nresource data.\n\nWhile the Search Ads 360 Reporting API provides metrics for most\nresources only at the client account level, some resources, like [`BiddingStrategy`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#biddingstrategy) can get metrics at the\nmanager and sub-manager levels.\n\nResource Ownership\n------------------\n\nThe following table shows the account-level ownership for each Search Ads 360 resource.\n\n| Search Ads 360 Resource | Account Level Ownership |\n|----------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|\n| [Customer](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.Customer) | Manager, Sub-manager and Client |\n| [AdGroup](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#google.ads.searchads360.v0.resources.AdGroup) | Client |\n| [AdGroupAd](/search-ads/reporting/api/reference/rpc) | Client |\n| [AdGroupCriterion](/search-ads/reporting/api/reference/rpc) | Client |\n| [BiddingStrategy](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#biddingstrategy) | Sub-manager and Client |\n| [Campaign](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaign) | Client |\n| [CampaignCriterion](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#campaigncriterion) | Client |\n| [ExtensionFeedItem](/search-ads/reporting/api/reference/rpc) | Client |\n| [ConversionAction](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#conversionaction) | Sub-manager (excluding metrics) and Client |\n| [CustomerManagerLink](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#customermanagerlink) | Sub-manager and Client |\n| [CustomColumn](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.resources#customcolumn) | Manager and Sub-manager |"]]
