리소스 이름

이름 계층 구조

Google Ads API에서 사용되는 리소스 이름은 Google Ads 내의 항목 조직을 반영하는 계층 구조입니다. 거의 모든 리소스는 Customer 하위 리소스 입니다. 이는 거의 모든 API 호출이 특정 Google Ads 계정을 타겟팅해야 한다는 사실을 반영합니다. 예를 들어 캠페인, 광고 그룹, 광고, 키워드는 모두 루트 고객 리소스의 하위 리소스입니다.

리소스 ID

Google Ads 항목 (고객, 캠페인 등)은 API 전반에서 리소스 이름으로 참조됩니다. 하지만 리소스 이름 자체에 계층 구조의 각 객체를 식별하는 고유한 숫자 리소스 ID가 있을 수 있습니다. 이러한 경우 리소스 이름을 파싱하여 이러한 리소스 ID를 추출하고 새 리소스 ID를 어셈블하는 것이 유용할 수 있습니다.

예를 들어 이전 표의 AdGroupAd 리소스 이름을 검토합니다.

customers/1234567890/adGroupAds/54321098765~2109876543210

다음과 같이 컬렉션 ID로 구분된 개별 리소스 ID로 분류할 수 있습니다.

개별 ID를 파싱하면 광고 그룹 광고의 고객 (customers/1234567890) 또는 광고 그룹(customers/1234567890/adGroupAds/54321098765)을 참조하는 새 리소스 이름을 파생시킬 수 있습니다.

공유 객체의 식별자

API의 대부분의 객체는 단일 특정 Google Ads 고객과 연결되어 있습니다. 하지만 여러 계정 간에 공유할 수 있는 객체 유형도 있습니다. 실제로 이러한 객체는 일반적으로 관리자가 만든 후 여러 고객 계정과 공유하는 제외 키워드 목록 또는 교차 계정 전환 액션과 같은 항목입니다.

이러한 객체의 리소스 이름은 API 호출을 전송하는 계정에 따라 다릅니다.

예: 교차 계정 전환 액션

교차 계정 전환 액션을 클라이언트 고객 계정 중 하나인 123-456-7890과 공유하는 관리자 계정 987-654-3210이 있다고 가정해 보겠습니다.

예를 들어 전환 액션의 전환 확인 기간을 업데이트하기 위해 관리자 계정에 API 호출을 하면 리소스 이름 customers/9876543210/conversionActions/257733534를 사용하여 공유 객체를 참조합니다.

공유 전환 액션 사용에 동의하기 위해 고객 계정 에 API 호출을 하면 리소스 이름 customers/1234567890/conversionActions/257733534를 사용하여 공유 전환 액션을 참조합니다.

이는 동일한 기본 전환 액션이지만 리소스 이름은 액세스하는 데 사용되는 계정을 기준으로 합니다.