ReachPlanService에 대한 요청은 승인된 개발자 토큰, OAuth 사용자 인증 정보, OAuth 사용자 인증 정보가 액세스할 수 있는 고객 ID를 제공해야 합니다.
이 가이드에서는 ReachPlanService에 특화된 인증 세부정보를 다룹니다. 아직 완료하지 않았다면 먼저 시작하기에 설명된 단계를 완료한 후 이 지점으로 돌아오세요.
개발자 토큰 및 OAuth 사용자 인증 정보
시작하기에 제시된 안내 외에도 다음 사항에 유의하세요.
- 다른 Google Ads API 서비스에서 사용하도록 이미 승인된 경우에도
ReachPlanService에 연결하려면 개발자 토큰을 적절한 허용 목록에 추가해야 합니다. 자세한 내용은 자격 요건을 참고하세요. - Google Ads API에 연결하려면 Google Ads API 서비스 약관에 동의해야 합니다.
- OAuth 새로고침 토큰을 소유한 사용자가
ReachPlanService에서 쿼리할 수 있는 고객 ID를 결정합니다. 이는 통합에 영향을 미치며 다음 섹션에서 자세히 설명합니다.
고객 ID
Google Ads API 내 대부분의 서비스는 특정 Google Ads 계정 및 캠페인에서 작동합니다. 따라서 대부분의 요청에는 관리하거나 쿼리하는 계정을 식별하는 고객 ID와 해당 고객 ID에 액세스할 수 있는 권한이 있는 OAuth 사용자 인증 정보가 모두 필요합니다. 하지만 ReachPlanService는 캠페인을 운영할 특정 고객 ID를 알기 전에 발생할 수 있는 동영상 계획 활동을 위한 것입니다.
내부 도구
조직 내에서 사용할 도구를 빌드하는 경우 다음 권장사항을 참고하세요.
직접 클라이언트 계정 액세스 권한이 없는 플래너
계획자가 클라이언트의 Google Ads 계정에 액세스할 수 없는 경우 개발자 토큰의 관리자 계정에 액세스할 수 있는 사용자에 대해 설치된 애플리케이션 흐름을 사용하여 OAuth 사용자 인증 정보를 생성합니다. 그런 다음 도구를 사용하는 각 팀의 Google Ads 계정을 만들거나 가져와서 관리자 계정에 연결합니다. ReachPlanService에 요청할 때는 사용자의 팀에 해당하는 고객 ID를 제공하세요.
고객 계정 액세스 권한이 있는 플래너
플래너가 고객의 계정을 관리하는 Google Ads 관리자 계정에 액세스할 수 있는 경우 앱에서 플래너의 OAuth 사용자 인증 정보를 사용할 수 있도록 웹 애플리케이션 흐름을 구현하세요. 그런 다음 요금제 고객에 해당하는 고객 ID를 전달할 수 있습니다.
외부 도구
외부 사용자를 위한 도구를 빌드하는 경우 다음과 유사한 접근 방식을 사용하는 것이 좋습니다.
클라이언트별 계정
개발자 토큰의 관리자 계정에 액세스할 수 있는 사용자에 대해 설치된 애플리케이션 흐름을 사용하여 OAuth 사용자 인증 정보를 생성합니다. 외부 고객별로 Google Ads 계정을 만들고 관리자 계정에 연결합니다. 그런 다음 고객이 계획을 생성할 때 해당 고객 ID를 제공하도록 도구를 구성합니다.
사용자가 부여한 액세스 권한
사용자가 웹 애플리케이션 흐름을 사용하여 도구에 계정 액세스 권한을 부여할 수 있도록 합니다. 사용자가 권한을 부여하면 CustomerService를 사용하여 액세스할 수 있는 Google Ads 계정 목록을 제공합니다.
목표는 플래너가 ReachPlanService를 사용할 때 최대한 원활하게 사용할 수 있도록 하는 것입니다. API를 통합하기 전에 상황에 따라 두 가지 접근 방식 중 하나를 선택하고 테스트할 고객 ID를 몇 개 식별하세요. 잘 모르겠다면 도구 유형에 대해 제안된 첫 번째 방법을 사용하세요.
다음 단계
미디어 계획을 지정하는 방법을 알아보세요.