Authentication

ReachPlanService에 대한 요청은 승인된 개발자 토큰, OAuth 사용자 인증 정보, OAuth 사용자 인증 정보가 액세스할 수 있는 고객 ID를 제공해야 합니다.

이 가이드에서는 ReachPlanService와 관련된 인증 세부정보를 다룹니다. 아직 완료하지 않았다면, 먼저 시작하기에 설명된 단계를 완료한 후 이 지점으로 돌아오세요.

개발자 토큰 및 OAuth 사용자 인증 정보

개발자 토큰이 다른 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를 몇 개 식별합니다. 잘 모르겠다면 도구 유형에 대해 제안된 첫 번째 접근 방식을 사용하세요.