Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Google Ads trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khi làm việc với API Google Ads, có nhiều nơi sử dụng địa chỉ email để quản lý thông tin liên hệ và quyền truy cập, trong đó quan trọng nhất là những nơi sau:
Email liên hệ của Google Ads API: Đây là email được liệt kê làm thông tin liên hệ trong Trung tâm API của giao diện người dùng Google Ads.
Email tài khoản Google Cloud Console: Đây là email có quyền quản trị đối với tài khoản Google Cloud Console dùng cho ứng dụng OAuth 2.0 của bạn.
(Các) email của tài khoản người quản lý Google Ads: Đây là những email có quyền quản trị trên(các) tài khoản Google Ads người quản lý mà bạn truy cập thông qua API Google Ads. Khi tạo mã làm mới cho ứng dụng của mình, bạn thường xác thực ứng dụng Google Ads API bằng một trong những email này.
Bạn nên dùng bí danh nhóm dùng chung để không bị mất quyền truy cập vào các tài khoản này khi từng thành viên trong nhóm chuyển nhóm hoặc rời khỏi công ty.
Phần còn lại của hướng dẫn này sẽ trình bày chi tiết từng email được liệt kê trước đó và cách bạn có thể cập nhật email đó để sử dụng bí danh nhóm dùng chung thay vì địa chỉ email của từng người dùng.
Email liên hệ về API Google Ads
Email liên hệ của Google Ads API là địa chỉ email mà bạn cung cấp khi đăng ký Google Ads API. Bạn nên đảm bảo có quyền truy cập vào bí danh này và thường xuyên theo dõi các email được gửi đến địa chỉ này. Google sử dụng địa chỉ email này để liên hệ với nhóm của bạn trong quá trình xem xét API, yêu cầu kiểm tra hoặc các trường hợp khẩn cấp về sản xuất cần được chú ý ngay lập tức. Sử dụng một bí danh nhóm dùng chung làm email liên hệ để đảm bảo toàn bộ nhóm nhận được những thông báo này.
Hãy làm theo các bước sau để cập nhật email liên hệ của API:
Trong mục Cài đặt tài khoản người quản lý, hãy nhấp vào Trung tâm API.
Trong phần Thông tin chi tiết về nhà phát triển, hãy lưu ý đến email liên hệ về API. Nhấp vào mũi tên xuống rồi chỉnh sửa email. Nhấp vào Lưu.
Tài khoản Google Cloud Console
Dự án Google API Console chứa thông tin xác thực OAuth của ứng dụng và kiểm soát quyền truy cập vào API Google Ads. Đảm bảo quyền truy cập vào tài khoản này bằng cách đặt một bí danh dùng chung làm chủ sở hữu tài khoản.
Hãy làm theo các bước sau để cập nhật chủ sở hữu dự án trên Google API Console:
Một phương thức phổ biến để quản lý tài khoản bằng Google Ads API là liên kết tất cả tài khoản của bạn trong một tài khoản người quản lý chung và thực hiện các lệnh gọi API đến tất cả tài khoản bằng thông tin đăng nhập của tài khoản người quản lý cấp cao nhất. Trong cấu hình này:
Nhà phát triển phát hành mã làm mới bằng thông tin đăng nhập của người dùng có quyền truy cập vào tài khoản người quản lý Google Ads.
Nhà phát triển đặt tiêu đề login_customer_id làm mã khách hàng của tài khoản người quản lý Google Ads và tiêu đề customer_id làm mã khách hàng của tài khoản mà các lệnh gọi API được thực hiện.
Một rủi ro tiềm ẩn của chế độ thiết lập này là nếu người dùng được uỷ quyền mất quyền truy cập vào tài khoản người quản lý Google Ads, thì mã làm mới sẽ không còn hợp lệ và tất cả các lệnh gọi API đều sẽ không thành công. Để tránh trường hợp này, bạn có thể mời một bí danh email dùng chung để quản lý tài khoản người quản lý Google Ads này với các cấp truy cập phù hợp.
Sử dụng bí danh email dùng chung này để phát hành mã làm mới nhằm thực hiện các lệnh gọi API.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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."]]
