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 资源的账号级所有权。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-29。
[null,null,["最后更新时间 (UTC)：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 |"]]
