Google Ads API를 사용할 때 이메일 주소가 연락처 및 액세스 관리에 사용되는 위치는 여러 곳이 있으며, 그중 가장 중요한 위치는 다음과 같습니다.
- Google Ads API 연락처 이메일: Google Ads UI의 API Center에 연락처로 등록된 이메일입니다.
- 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 센터를 클릭합니다.
개발자 세부정보에서 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 호출을 위한 새로고침 토큰을 발행합니다.