공유 별칭
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
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에서는 API 검토, 감사 요청 또는 즉각적인 조치가 필요한 프로덕션 긴급 상황 중에 이 이메일 주소를 사용하여 팀에 연락합니다. 전체 팀이 알림을 받을 수 있도록 공유 팀 별칭을 연락처 이메일로 사용하세요.
API 연락처 이메일을 업데이트하려면 다음 단계를 따르세요.
Google Ads 관리자 계정에 로그인합니다.
화면 왼쪽 하단에서 관리를 클릭합니다.
관리자 계정 설정에서 API 센터를 클릭합니다.
개발자 세부정보에서 API 연락처 이메일을 확인합니다. 아래쪽 화살표를 클릭하고 이메일을 수정합니다. 저장을 클릭합니다.
Google Cloud 콘솔 계정
Google API 콘솔 프로젝트에는 애플리케이션의 OAuth 사용자 인증 정보가 포함되어 있으며 Google Ads API에 대한 액세스를 제어합니다. 공유 별칭을 계정 소유자로 지정하여 이 계정에 액세스할 수 있도록 합니다.
다음 단계에 따라 Google API 콘솔 프로젝트의 소유자를 업데이트하세요.
- Google API 콘솔에 로그인합니다.
- 페이지 왼쪽 상단의 드롭다운 메뉴에서 프로젝트를 선택합니다.
- 왼쪽 메뉴에서 IAM 및 관리자 > IAM으로 이동합니다.
- 액세스 권한 부여 버튼을 클릭합니다.
- 주 구성원 추가 섹션에 공유 이메일 주소를 입력합니다.
- 소유자 역할을 할당합니다.
- 저장 버튼을 클릭합니다. 액세스 권한 부여 및 취소에 대해 자세히 알아보려면 클라우드 문서를 참고하세요.
Google Ads 관리자 계정
Google Ads API를 사용하여 계정을 관리하는 일반적인 방법은 공통 관리자 계정 아래에 모든 계정을 연결하고 최상위 관리자 계정의 사용자 인증 정보를 사용하여 모든 계정에 API 호출을 하는 것입니다. 이 구성에서
- 개발자는 Google Ads 관리자 계정에 액세스할 수 있는 사용자의 사용자 인증 정보를 사용하여 갱신 토큰을 발급합니다.
- 개발자는
login_customer_id 헤더를 Google Ads 관리자 계정의 고객 ID로 설정하고 customer_id 헤더를 API 호출이 이루어지는 계정의 고객 ID로 설정합니다.
이 설정의 잠재적 위험 중 하나는 승인된 사용자가 Google Ads 관리자 계정에 대한 액세스 권한을 잃으면 갱신 토큰이 더 이상 유효하지 않게 되고 모든 API 호출이 실패한다는 것입니다. 이러한 상황을 방지하려면 공유 이메일 별칭을 초대하여 적절한 액세스 수준으로 이 Google Ads 관리자 계정을 관리하면 됩니다.
이 공유 이메일 별칭을 사용하여 API 호출을 위한 새로고침 토큰을 발급합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-09-05(UTC)
[null,null,["최종 업데이트: 2025-09-05(UTC)"],[[["\u003cp\u003eWhen working with the Google Ads API, ensure continuous access by using shared team aliases for contact, access management, and authentication purposes instead of individual user emails.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API contact email is used for crucial communications, update it to a shared alias to keep your team informed about API reviews, audit requests, and production emergencies.\u003c/p\u003e\n"],["\u003cp\u003eSafeguard your Google Cloud Console account by granting ownership to a shared team alias, ensuring access to your application's OAuth credentials and control over API access.\u003c/p\u003e\n"],["\u003cp\u003eFor managing multiple Google Ads accounts, link them under a manager account and grant access to a shared alias for refresh token generation and uninterrupted API functionality.\u003c/p\u003e\n"],["\u003cp\u003eRegularly monitor and update these email addresses and access levels to maintain seamless API operations and avoid disruptions caused by personnel changes.\u003c/p\u003e\n"]]],[],null,["# Shared aliases\n\nWhen working with the Google Ads API, there are multiple places where email addresses\nare used for contact and access management, the most important of which are the\nfollowing:\n\n- **Google Ads API contact email**: This is the email listed as the contact in the API Center of the Google Ads UI.\n- **Google Cloud Console account email**: This is the email that has administrator access to the Google Cloud Console account used for your OAuth 2.0 application.\n- **Google Ads manager account email(s)**: These are the emails that have administrator permissions on the manager Google Ads account(s) you access through the Google Ads API. When you generate a refresh token for your application, you usually authenticate your Google Ads API application with one of these emails.\n\nWe strongly recommend using shared team aliases so that you don't lose access to\nthese accounts when individual team members switch teams or leave the company.\nThe rest of this guide elaborates on each of the emails listed earlier and how\nyou can update it to use a shared team alias instead of an individual user's\nemail address.\n\nGoogle Ads API contact email\n----------------------------\n\nThe Google Ads API contact email is an email address you provide when signing up for\nthe Google Ads API. You should ensure access to this alias and monitor emails sent to\nthis address regularly. Google uses this email address to contact your team\nduring API reviews, audit requests, or production emergencies that require\nimmediate attention. Use a shared team alias as the contact email to ensure that\nthe whole team receives these notifications.\n\nFollow these steps to update the API contact email:\n\n1. Sign in to your Google Ads [Manager\n Account](//ads.google.com/home/tools/manager-accounts/).\n\n2. Click **Admin** at the bottom left of the screen.\n\n3. Under **Manager account settings** , click **API center**.\n\n4. Under **Developer details** , note the API contact email. Click the down arrow\n and edit the email. Click **Save**.\n\nGoogle Cloud Console account\n----------------------------\n\nThe **Google API Console** project contains your application's OAuth credentials\nand controls access to the Google Ads API. Ensure access to this account by making a\nshared alias the account owner.\n\nFollow these steps to update the Google API Console project's owner:\n\n- Sign in to [**Google API Console**](//console.developers.google.com).\n- Select your project from the drop-down menu on the top-left corner of the page.\n- Navigate to **IAM and admin \\\u003e IAM** from the left menu.\n- Click the **Grant Access** button.\n- Enter the shared email address under the **Add principals** section.\n- Assign the **Owner** role.\n- Click the **Save** button. Refer to the Cloud documentation to learn more about [granting and revoking access](//cloud.google.com/iam/docs/granting-changing-revoking-access#single-role).\n\nGoogle Ads manager account\n--------------------------\n\nA common method of managing accounts using the Google Ads API is to link all your\naccounts under a common manager account, and make API calls to all the accounts\nusing the top-most manager account's credentials. In this configuration:\n\n- The developer issues a refresh token using the credentials of a user who has access to the Google Ads manager account.\n- The developer sets the [`login_customer_id`](/google-ads/api/docs/get-started/select-account#user_access_login_customer_id_and_customer_id) header as the customer ID of the Google Ads manager account, and the `customer_id` header as the customer ID of the account to which API calls are made.\n\nOne potential risk of this setup is that if the authorized user loses access to\nthe Google Ads manager account, the refresh token is no longer valid and all API\ncalls fail. To avoid this scenario, you can invite a shared email alias to\nmanage this Google Ads manager account with the [appropriate access levels](//support.google.com/google-ads/answer/9978556).\nUse this shared email alias to issue the refresh token for making API calls."]]
