이름 계층 구조
Search Ads 360 Reporting API에서 사용되는 리소스 이름은 계층적이며 Search Ads 360 내의 항목 구성을 반영합니다. 거의 모든 리소스는 Customer 리소스의 하위 리소스입니다. 이는 거의 모든 API 호출이 특정 Search Ads 360 계정을 타겟팅해야 한다는 사실을 반영합니다. 예를 들어 캠페인, 광고 그룹, 광고, 키워드는 모두 루트 고객 리소스의 하위 리소스입니다.
| 리소스 | 리소스 이름 |
|---|---|
| 고객 | customers/1234567890
|
| 캠페인 | customers/1234567890/campaigns/8765432109
|
| 광고그룹 | 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)을 참조하는 새 리소스 이름을 파생할 수 있습니다.