리소스 이름

이름 계층 구조

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:
"1234567890"
광고그룹 ID:
"54321098765"
광고그룹 광고 ID:
"2109876543210"
컬렉션 ID
"customers"
"adGroupAds"

개별 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입니다.

동일한 기본 전환 액션이지만 리소스 이름은 상대적입니다. 계정에 다시 액세스할 수 있습니다.

이전
개요
다음
서비스 메서드