ReachPlanService에 대한 요청은 OAuth
사용자 인증 정보와 OAuth 사용자 인증 정보가 액세스할 수 있는 고객 ID를 제공해야 합니다. 또한 OAuth 사용자 인증 정보와 연결된 Google Cloud 프로젝트가 이 서비스를 사용하도록 승인되어야 합니다.
이 가이드에서는
ReachPlanService와 관련된 인증 세부정보를 설명합니다. 아직 완료하지 않았다면 먼저
시작하기에 설명된 단계를 완료한 후 이 가이드로 돌아오세요.
OAuth 사용자 인증 정보
시작하기에 제시된 안내 외에도 다음 사항에 유의하세요.
- 다른 Google Ads API 서비스에서 이미 사용하도록 승인된 경우에도
ReachPlanService에 연결하려면 Google Cloud 프로젝트 번호를 적절한 허용 목록 에 추가해야 합니다. 자세한 내용은 자격 요건을 참고하세요. - Google Ads API에 연결하려면 Google Ads API 서비스 약관에 동의해야 합니다.
- OAuth 갱신 토큰을 소유한 사용자가
쿼리할 수 있는 고객 ID를 결정합니다.
ReachPlanService이는 통합에 영향을 미치며 다음 섹션에서 자세히 설명합니다.
고객 ID
Google Ads API 내의 대부분의 서비스는 특정 Google Ads 계정 및 캠페인에서 작동합니다. 따라서 대부분의 요청에는 타겟 계정을 식별하는 고객 ID와 해당 고객 ID에 액세스할 수 있는 권한이 부여된 OAuth 사용자 인증 정보가 모두 필요합니다.
그러나 ReachPlanService는 캠페인을 실행하기 위해 특정 고객 계정을 설정하기 전에 발생할 수 있는 동영상 계획
활동을 위한 것입니다.
내부 도구
조직 내에서 내부적으로 사용할 도구를 빌드하는 경우 다음 옵션을 고려하세요.
- 클라이언트 계정에 직접 액세스할 수 없는 기획자: 기획자가 클라이언트의 Google Ads 계정에 액세스할 수 없는 경우 관리자 계정에 액세스할 수 있는 사용자의 단일 사용자 인증 흐름을 사용하여 OAuth 사용자 인증 정보를 생성합니다. 그런 다음 도구를 사용하여 각 팀의
Google Ads 계정을 만들거나 가져와서 관리자
계정에 연결합니다.
ReachPlanService에 요청할 때 사용자 팀에 해당하는 고객 ID 를 제공합니다. - 클라이언트 계정에 액세스할 수 있는 기획자: 기획자가 클라이언트의 계정을 관리하는 Google Ads 관리자 계정에 액세스할 수 있는 경우 다중 사용자 인증 흐름을 구현하여 애플리케이션에서 기획자의 OAuth 사용자 인증 정보를 사용할 수 있도록 합니다. 그런 다음 고객 계획에 해당하는 고객 ID를 전달할 수 있습니다.
외부 도구
서드 파티 또는 외부 사용자를 위한 도구를 빌드하는 경우 다음 옵션을 사용하는 것이 좋습니다.
- 고객 계정별: 관리자 계정에 액세스할 수 있는 사용자의 단일 사용자 인증 흐름을 사용하여 OAuth 사용자 인증 정보를 생성합니다. 외부 클라이언트별로 Google Ads 계정을 만들고 관리자 계정에 연결합니다. 계획을 생성할 때 클라이언트의 해당 고객 ID를 제공하도록 도구를 구성합니다.
- 사용자가 부여한 액세스 권한: 사용자가 다중 사용자 인증 흐름을 사용하여 도구에 계정 액세스 권한을 부여하도록 허용합니다. 사용자가 권한을 부여하면
CustomerService를 사용하여 액세스할 수 있는 Google Ads 계정 목록을 가져옵니다.
API를 통합하기 전에 시스템 요구사항에 따라 위의 접근 방식 중 하나를 선택하고 몇 가지 테스트 고객 ID를 식별합니다. 확실하지 않은 경우 연결된 계정으로 단일 사용자 인증 흐름 부터 시작하세요.
다음 단계
미디어 계획을 지정하는 방법을 알아보세요.