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를 확인합니다. 확실하지 않다면 도구 유형에 대해 첫 번째 추천 접근 방식을 사용하세요.