Google Ads API를 사용할 때 연락처 및 액세스 관리에 이메일 주소가 사용되는 여러 위치가 있으며 그중 가장 중요한 위치는 다음과 같습니다.
- Google Ads API 연락처 이메일: Google Ads UI의 API 센터에 연락처로 등록된 이메일입니다.
- Google Cloud 콘솔 계정 이메일: OAuth 2.0 애플리케이션에 사용되는 Google Cloud 콘솔 계정에 대한 관리자 액세스 권한이 있는 이메일입니다.
- Google Ads 관리자 계정 이메일: Google Ads API를 통해 액세스하는 관리자 Google Ads 계정에 대해 관리자 권한이 있는 이메일입니다. 애플리케이션에 대한 갱신 토큰을 생성할 때 일반적으로 이러한 이메일 중 하나를 사용하여 Google Ads API 애플리케이션을 인증합니다.
개별 팀 구성원이 팀을 전환하거나 회사를 떠날 때 이 계정에 대한 액세스 권한을 잃지 않도록 공유 팀 별칭을 사용하는 것이 좋습니다. 이 가이드의 나머지 부분에서는 앞에서 나열한 각 이메일과 개별 사용자의 이메일 주소 대신 공유 팀 별칭을 사용하도록 업데이트하는 방법을 자세히 설명합니다.
Google Ads API 연락처 이메일
Google Ads API 연락처 이메일은 Google Ads API에 가입할 때 제공하는 이메일 주소입니다. 이 별칭에 액세스할 수 있는지 확인하고 이 주소로 전송되는 이메일을 정기적으로 모니터링해야 합니다. Google은 API 검토, 감사 요청 또는 즉각적인 조치가 필요한 프로덕션 비상 상황 발생 시 이 이메일 주소를 사용하여 개발자의 팀에 연락합니다. 팀 전체가 이러한 알림을 수신할 수 있도록 공유 팀 별칭을 연락처 이메일로 사용하세요.
API 연락처 이메일을 업데이트하려면 다음 단계를 따르세요.
- Google Ads API 액세스를 신청할 때 사용한 Google Ads 관리자 계정으로 로그인합니다. 이 계정은 개발자 토큰이 있는 계정과 동일합니다.
- 도구 및 설정 > API 센터로 이동합니다.
- API 연락처 이메일 섹션 아래에 있는 화살표를 클릭합니다.
- 이메일 주소를 업데이트하고 저장 버튼을 클릭합니다.
Google Cloud 콘솔 계정
Google API 콘솔 프로젝트에는 애플리케이션의 OAuth 사용자 인증 정보가 포함되며 Google Ads API에 대한 액세스를 제어합니다. 공유 별칭을 계정 소유자로 만들어 이 계정에 액세스할 수 있도록 합니다.
Google API 콘솔 프로젝트의 소유자를 업데이트하려면 다음 단계를 따르세요.
- Google API 콘솔에 로그인합니다.
- 페이지 왼쪽 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.
- 왼쪽 메뉴에서 IAM 및 관리자 > IAM으로 이동합니다.
- 액세스 권한 부여 버튼을 클릭합니다.
- 주 구성원 추가 섹션 아래에 공유 이메일 주소를 입력합니다.
- 소유자 역할을 할당합니다.
- 저장 버튼을 클릭합니다. 액세스 권한 부여 및 취소에 대한 자세한 내용은 Cloud 문서를 참조하세요.
Google Ads 관리자 계정
Google Ads API를 사용하여 계정을 관리하는 일반적인 방법은 모든 계정을 공통 관리자 계정에 연결하고 최상위 관리자 계정의 사용자 인증 정보를 사용하여 모든 계정에 대해 API 호출을 수행하는 것입니다. 이 구성에서
- 개발자는 Google Ads 관리자 계정에 액세스할 수 있는 사용자의 사용자 인증 정보를 사용하여 갱신 토큰을 발급합니다.
- 개발자는
login_customer_id헤더를 Google Ads 관리자 계정의 고객 ID로,customer_id헤더를 API 호출이 이루어지는 계정의 고객 ID로 설정합니다.
이 설정의 잠재적인 위험 중 하나는 승인된 사용자가 Google Ads 관리자 계정에 액세스하지 못하게 되면 갱신 토큰이 더 이상 유효하지 않고 모든 API 호출이 실패하는 것입니다. 이러한 상황을 방지하려면 적절한 액세스 수준으로 Google Ads 관리자 계정을 관리할 공유 이메일 별칭을 초대하세요. 이 공유 이메일 별칭을 사용하여 API 호출을 위한 갱신 토큰을 발급합니다.