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 리소스의 계정 수준 소유권이 나와 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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 |"]]
