ReachPlanService에 대한 요청은 OAuth 사용자 인증 정보와 OAuth 사용자 인증 정보가 액세스할 수 있는 고객 ID를
제공해야 합니다. 또한 OAuth 사용자 인증 정보가 속한 Google Cloud 프로젝트가 이 서비스를 사용하도록 승인되어야 합니다.
이 가이드에서는
ReachPlanService와 관련된 인증 세부정보를 다룹니다. 아직 완료 전이라면,
먼저
시작하기에 설명된 단계를 완료한 후 이 지점으로 돌아오세요.
OAuth 사용자 인증 정보
시작하기에 제시된 안내 외에도 다음 사항에 유의하세요.
- Google Cloud 프로젝트 번호는 다른 Google Ads API 서비스에서 사용하도록 이미 승인된 경우에도
ReachPlanService에 연결하기 위해 적절한 허용 목록 에 추가해야 합니다. 자세한 내용은 자격 요건을 참고하세요. - Google Ads API에 연결하려면 Google Ads API 서비스 약관에 동의해야 합니다.
- OAuth 갱신 토큰을 소유한 사용자는
쿼리할 수 있는 고객 ID를
ReachPlanService에서 결정합니다. 이는 통합에 영향을 미치며 다음 섹션에서 자세히 설명합니다.
고객 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를 몇 개 식별합니다. 잘 모르겠다면 도구 유형에 대해 제안된 첫 번째 접근 방식을 사용하세요.
다음 단계
미디어 계획을 지정하는 방법을 알아보세요.