이름 계층 구조
Google Ads API에서 사용되는 리소스 이름은
Google Ads의 항목 구성 거의 모든 리소스가 하위 리소스임
(Customer)
이는 거의 모든 API 호출이
특정 Google Ads 계정에만 적용됩니다. 예: 캠페인, 광고 그룹, 광고, 키워드
루트 고객 리소스의 모든 하위 리소스입니다.
| 리소스 | 리소스 이름 |
|---|---|
| 고객 | customers/1234567890
|
| 캠페인 | customers/1234567890/campaigns/8765432109
|
| 광고그룹 | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
리소스 ID
Google Ads 항목 (고객, 캠페인 등)은 해당 리소스에 의해 참조됨 이름을 지정할 수 있습니다 하지만 이 리소스는 이름 자체에는 고유한 숫자 리소스가 있을 수 있고 ID는 계층 구조의 각 객체에 대해서 이러한 경우에는 리소스 이름을 사용하여 이러한 리소스 ID를 추출하고 새 ID를 조합합니다.
예를 들어 이전 테이블에서 AdGroupAd 리소스 이름을 확인합니다.
customers/1234567890/adGroupAds/54321098765~2109876543210
이는 개별 리소스 ID( 컬렉션 ID) 방법은 다음과 같습니다.
| 리소스 이름 구성요소 | |||||||
|---|---|---|---|---|---|---|---|
| 리소스 ID |
|
||||||
| 컬렉션 ID |
|
||||||
개별 ID를 파싱하면 참조할 새 리소스 이름을 가져올 수 있습니다.
광고그룹 광고의 고객 (customers/1234567890) 또는 광고그룹
(customers/1234567890/adGroupAds/54321098765).
공유 객체의 식별자
API에 있는 대부분의 객체는 하나의 특정 Google Ads와 연결되어 있습니다. 있습니다. 그러나 두 객체 간에 공유할 수 있는 몇 가지 객체 유형이 여러 계정을 사용할 수 있습니다. 실제로 사용되는 키워드는 제외 키워드 및 목록 또는 교차 계정 전환 액션이 보통 관리자가 생성한 다음 많은 고객 계정과 공유됩니다.
이와 같은 객체의 리소스 이름은 계정에 연결해야 합니다.
예: 교차 계정 전환 액션
교차 계정을 공유하는 관리자 계정 987-654-3210이(가) 있다고 가정해 보겠습니다.
고객 계정(123-456-7890) 중 하나에 연결된 전환 액션:
예를 들어 전환 업데이트 등을 위해 관리자 계정에 API 호출 실행
작업의 전환 확인 기간이 리소스 이름을 사용하여 공유 객체를 참조합니다.
customers/9876543210/conversionActions/257733534
클라이언트 계정에 API를 호출하여 공유된
전환 액션이 리소스 이름을 사용하여 이를 참조합니다.
customers/1234567890/conversionActions/257733534입니다.
동일한 기본 전환 액션이지만 리소스 이름은 상대적입니다. 계정에 다시 액세스할 수 있습니다.