공유 별칭

Google Ads API를 사용할 때 이메일 주소는 연락처 및 액세스 관리를 위해 여러 위치에서 사용됩니다. 가장 중요한 것은 다음과 같습니다.

  • Google Ads API 연락처 이메일: Google Cloud 프로젝트에서 소유자 또는 편집자 역할이 할당된 이메일 주소로, Google에서 필수 서비스 공지 (MSA) 및 관리 알림을 전송하는 데 사용됩니다.
  • Google Cloud 콘솔 계정 이메일: OAuth 2.0 애플리케이션에 사용되는 Google Cloud 프로젝트에 대한 관리자 액세스 권한이 있는 이메일입니다.
  • Google Ads 관리자 계정 액세스: Google Ads API를 통해 액세스하는 Google Ads 관리자 계정에 대한 액세스 권한이 있는 서비스 계정(권장) 또는 공유 이메일 별칭입니다.

이 가이드의 나머지 부분에서는 앞서 나열된 각 계정과 통합이 개별 사용자의 이메일 주소에 의존하지 않도록 구성하는 방법을 자세히 설명합니다.

Google Ads API 연락처 이메일

Google은 Google Cloud 프로젝트의 소유자 및 편집자 역할과 연결된 이메일 주소로 관리 알림, API 검토 업데이트, 감사 요청, 필수 서비스 공지 (MSA), 프로덕션 긴급 통신을 전송합니다 (Google Ads UI의 기존 API 센터 연락처 이메일 설정이 지원 중단되었으므로 새 API 연락처 이메일 참조).

연락처 이메일을 업데이트하고 전체 팀이 이러한 알림을 받도록 하려면 Google Cloud 프로젝트의 공유 팀 별칭에 소유자 또는 편집자 역할을 부여하고 해당 별칭으로 전송된 이메일을 정기적으로 모니터링하세요.

Google Cloud 콘솔 계정

Google Cloud 콘솔 프로젝트에는 애플리케이션의 OAuth 사용자 인증 정보가 포함되어 있으며 Google Ads API에 대한 액세스를 제어합니다. 공유 팀 별칭에 소유자 (또는 편집자) 역할을 부여하여 이 프로젝트에 대한 액세스 권한을 부여합니다.

공유 별칭을 Google Cloud 프로젝트 소유자로 추가하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에 로그인합니다.
  2. 페이지 상단의 프로젝트 선택기에서 프로젝트를 선택합니다.
  3. 탐색 메뉴에서 IAM 및 관리자 > IAM으로 이동합니다.
  4. 액세스 권한 부여를 클릭합니다.
  5. 주 구성원 추가 섹션의 새 주 구성원 필드에 공유 이메일 주소를 입력합니다.
  6. 역할 할당 섹션에서 역할 선택을 클릭하고 기본 > 소유자 (또는 기본 > 편집자)를 선택합니다.
  7. 저장을 클릭합니다. Google Cloud 조직 외부의 이메일 주소 (또는 조직이 없는 프로젝트)에 소유자 역할을 부여한 경우 Google Cloud는 공유 별칭으로 초대 이메일을 전송하며, 이 초대를 수락해야 역할이 적용됩니다. 액세스 권한 부여 및 취소에 대한 자세한 내용은 Cloud 문서를 참조하세요.

Google Ads 관리자 계정

Google Ads API를 사용하여 계정을 관리하는 일반적인 방법은 모든 계정을 공통 관리자 계정에 연결하고 최상위 관리자 계정의 사용자 인증 정보를 사용하여 모든 계정에 API를 호출하는 것입니다. 이 구성에서 개발자는 login-customer-id 요청 헤더(또는 login_customer_id 클라이언트 라이브러리 구성 설정)를 Google Ads 관리자 계정의 10자리 고객 ID (하이픈 제외)로 설정하고 타겟 customer_id를 API 호출이 이루어지는 운영 계정으로 설정합니다.

권장사항: 서비스 계정 사용

서비스 계정을 사용하는 것이 Google Ads 관리자 계정을 인증하고 액세스하는 데 선호되는 방법입니다. 개별 사용자 계정과 달리 서비스 계정은 Google Cloud 프로젝트 내에서 관리되며 특정 개인과 연결되지 않으므로 팀원이 역할을 변경하거나 퇴사할 때 서비스 중단이 발생하지 않습니다. 서비스 계정 가이드에 따라 서비스 계정을 만들고 Google Ads 관리자 계정에 대한 액세스 권한을 부여합니다.

대안: 공유 이메일 별칭 사용

통합에서 서비스 계정을 사용할 수 없고 대신 단일 사용자 인증 워크플로를 사용하는 경우 Google Ads 관리자 계정에 액세스할 수 있는 사용자가 OAuth 2.0 갱신 토큰을 발급합니다.

사용자 인증 정보를 사용할 때 이 시나리오를 방지하려면 다음 안내를 따르세요.

  1. 패스키 인증이 사용 설정된 활성 Google 계정에서 지원하는 공유 이메일 별칭을 초대하여 적절한 액세스 수준으로 이 Google Ads 관리자 계정을 관리합니다.
  2. 공유 이메일 별칭을 사용하여 초대를 수락합니다.
  3. 이 공유 이메일 별칭을 사용하여 API 호출을 위한 OAuth 갱신 토큰을 발급합니다.
이전
비율 제한
다음
최신 소식 받기