ReachPlanService에 대한 요청은
승인된 개발자 토큰, OAuth 사용자 인증 정보, OAuth 사용자 인증 정보가 액세스할 수 있는
고객 ID를 제공해야 합니다.
이 가이드에서는 ReachPlanService와 관련된 인증 세부정보를 다룹니다. 아직 완료하지 않았다면 먼저 시작하기에 설명된 단계를 완료한 후 여기로 돌아오세요.
개발자 토큰 및 OAuth 사용자 인증 정보
시작하기에서 제공하는 안내 외에도 다음 사항에 유의하세요.
- 개발자 토큰을 허용 목록에 추가하여
ReachPlanService에 연결해야 합니다. 이미 다른 Google Ads API 서비스와 함께 사용하도록 승인된 경우에도 마찬가지입니다. 자세한 내용은 자격요건을 참고하세요. - 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를 몇 개 확인합니다. 확실하지 않다면 도구 유형에 추천되는 첫 번째 방법을 사용하세요.