Khi làm việc với Google Ads API, địa chỉ email được dùng ở nhiều nơi để liên hệ và quản lý quyền truy cập. Quan trọng nhất trong số này là:
- Email liên hệ của Google Ads API: Địa chỉ email được chỉ định vai trò Chủ sở hữu hoặc Người chỉnh sửa trong dự án trên đám mây của bạn trên Google Cloud. Google sử dụng địa chỉ email này để gửi Thông báo bắt buộc về dịch vụ (MSA) và thông báo quản trị.
- Email tài khoản Google Cloud Console: Email có quyền quản trị đối với dự án trên đám mây của Google được dùng cho ứng dụng OAuth 2.0 của bạn.
- Quyền truy cập vào tài khoản người quản lý Google Ads: Tài khoản dịch vụ (nên dùng) hoặc email đại diện dùng chung có quyền truy cập vào(các) tài khoản người quản lý Google Ads được truy cập thông qua Google Ads API.
Phần còn lại của hướng dẫn này trình bày chi tiết về từng tài khoản được liệt kê ở trên và cách bạn có thể định cấu hình các tài khoản đó để hoạt động tích hợp không phụ thuộc vào địa chỉ email của một người dùng cá nhân.
Email liên hệ về Google Ads API
Google sẽ gửi thông báo quản trị, thông tin cập nhật về việc xem xét API, yêu cầu kiểm tra, Thông báo bắt buộc về dịch vụ (MSA) và liên lạc trong trường hợp khẩn cấp về môi trường thực tế đến các địa chỉ email liên kết với vai trò Chủ sở hữu và Người chỉnh sửa của dự án trên đám mây Google Cloud (xem Email liên hệ mới về API, vì chế độ cài đặt email liên hệ cũ của Trung tâm API trong giao diện người dùng Google Ads đã ngừng hoạt động).
Để cập nhật email liên hệ và đảm bảo rằng toàn bộ nhóm của bạn đều nhận được những thông báo này, hãy cấp vai trò Chủ sở hữu hoặc Người chỉnh sửa cho một email đại diện chung của nhóm trong dự án Google Cloud của bạn và thường xuyên theo dõi các email được gửi đến email đại diện đó.
Tài khoản Google Cloud Console
Dự án Google Cloud 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 Google Ads API. Đảm bảo quyền truy cập vào dự án này bằng cách cấp cho một bí danh nhóm dùng chung vai trò Chủ sở hữu (hoặc Người chỉnh sửa).
Hãy làm theo các bước sau để thêm email đại diện dùng chung làm chủ sở hữu dự án trên Google Cloud:
- Đăng nhập vào Google Cloud Console.
- Chọn dự án của bạn trong bộ chọn dự án ở đầu trang.
- Trong trình đơn điều hướng, hãy chuyển đến IAM & Admin > IAM (IAM và Quản trị viên > IAM).
- Nhấp vào Cấp quyền truy cập.
- Trong mục Thêm người dùng chính, hãy nhập địa chỉ email dùng chung vào trường Người dùng chính mới.
- Trong phần Chỉ định vai trò, hãy nhấp vào Chọn vai trò rồi chọn Cơ bản > Chủ sở hữu (hoặc Cơ bản > Người chỉnh sửa).
- Nhấp vào Lưu. Nếu bạn cấp vai trò Chủ sở hữu cho một địa chỉ email bên ngoài tổ chức của bạn trên Google Cloud (hoặc trong một dự án không có tổ chức), thì Google Cloud sẽ gửi một email gửi lời mời đến email đại diện dùng chung. Người nhận phải chấp nhận lời mời này thì vai trò mới có hiệu lực. Tham khảo tài liệu về Cloud để tìm hiểu thêm về việc cấp và thu hồi quyền truy cập.
Tài khoản người quản lý Google Ads
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 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 đặt tiêu đề của yêu cầu login-customer-id (hoặc chế độ cài đặt cấu hình thư viện ứng dụng login_customer_id) thành mã khách hàng gồm 10 chữ số (không có dấu gạch nối) của tài khoản người quản lý Google Ads, đồng thời đặt mục tiêu customer_id thành tài khoản điều hành mà lệnh gọi API được thực hiện.
Nên dùng: Sử dụng tài khoản dịch vụ
Sử dụng tài khoản dịch vụ là phương pháp ưu tiên để xác thực và truy cập vào tài khoản người quản lý Google Ads. Không giống như tài khoản người dùng cá nhân, tài khoản dịch vụ được quản lý trong dự án trên đám mây của Google Cloud và không liên kết với một người cụ thể, giúp ngăn chặn tình trạng gián đoạn khi thành viên trong nhóm thay đổi vai trò hoặc rời khỏi công ty. Làm theo hướng dẫn về tài khoản dịch vụ để tạo tài khoản dịch vụ và cấp cho tài khoản đó quyền truy cập vào tài khoản người quản lý Google Ads của bạn.
Cách khác: Sử dụng email đại diện dùng chung
Nếu quá trình tích hợp của bạn không thể sử dụng tài khoản dịch vụ mà dựa vào quy trình xác thực một người dùng, thì người dùng có quyền truy cập vào tài khoản người quản lý Google Ads sẽ cấp mã làm mới OAuth 2.0.
Cách tránh trường hợp này khi sử dụng thông tin đăng nhập của người dùng:
- Mời một email đại diện dùng chung (được hỗ trợ bởi một Tài khoản Google đang hoạt động đã bật tính năng xác minh bằng khoá truy cập) để quản lý tài khoản người quản lý Google Ads này với cấp truy cập phù hợp.
- Chấp nhận lời mời bằng email đại diện dùng chung.
- Sử dụng email đại diện dùng chung này để cấp mã làm mới OAuth cho việc thực hiện lệnh gọi API.