Search Ads 360 帳戶階層和資源擁有權
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
新版 Search Ads 360 階層提供三種帳戶類型：
管理員帳戶 (舊稱「代理商帳戶」)這是 Search Ads 360 帳戶階層的頂層，用於低層級副管理員和客戶帳戶的管理和報表。
副管理員帳戶 (舊稱「廣告客戶帳戶」)。副管理員帳戶可用於管理層級較低的帳戶 (副管理員和客戶帳戶)，以及製作這些帳戶的報表。
客戶帳戶 - 先前稱為「引擎帳戶」。客戶帳戶包含廣告活動、廣告群組和其他項目。
進一步瞭解 Search Ads 360 帳戶階層。
每個 Search Ads 360 資源的擁有者，可能是管理員、副管理員或客戶帳戶。
如要查詢資源，您必須具備擁有者帳戶層級或更高的驗證。在適當的擁有者帳戶層級完成驗證後，您必須在查詢中加入擁有所要求資料的帳戶特定 ID。
舉例來說，CustomColumn資源的擁有者為管理員或副管理員帳戶層級，而Campaign資源的擁有者為客戶帳戶層級。也就是說，您必須在管理員或副管理員帳戶層級進行驗證，才能查詢 CustomColumn。您還必須在查詢中指定擁有要求 CustomColumn 的管理員或副管理員帳戶 ID。如要查詢 Campaign 資料，您可以透過管理員或副管理員帳戶層級進行驗證。此外，您必須在查詢中指定擁有要求廣告活動資料的客戶帳戶 ID。
瞭解帳戶階層
如要使用 Search Ads 360 Reporting API 建立報表，您必須先瞭解帳戶階層，也就是在所查詢的管理員、副管理員和客戶帳戶之間找出父子關係。
識別管理員或副管理員帳戶下的子項
如要查看管理員或副管理員帳戶下層的子帳戶結構，請建立 Search Ads 360 查詢語言陳述式，從 CustomerClient 資源查詢所有直接子帳戶。接著，針對每個直接子帳戶重複查詢 CustomerClient 資源，以便傳回間接連結至管理員或副管理員帳戶的子帳戶。
識別帳戶的管理員 (上層)
如要識別客戶帳戶的父項，請查詢 CustomerManagerLink 資源。
使用多個帳戶層級的資料建立報表
在某些情況下，您需要使用多個帳戶層級的資料來建立報表。舉例來說，您可能會從客戶帳戶層級的 Campaign 資源取得大部分資料，但也需要從副管理員帳戶層級的 CustomColumn 資源取得輔助資料。
擁有不同帳戶層級的資源
部分資源 (例如 BiddingStrategy) 可由管理員、副管理員和客戶帳戶層級擁有。在這些執行個體中，客戶帳戶通常可以存取不同的資源資料子集。
雖然 Search Ads 360 Reporting API 只會在客戶帳戶層級為大多數資源提供指標，但某些資源 (例如 BiddingStrategy) 則可在管理員和副管理員層級取得指標。
資源擁有權
下表列出各項 Search Ads 360 資源的帳戶層級擁有權。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[[["\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 |"]]
