Khi làm việc với API Google Ads, có nhiều nơi sử dụng địa chỉ email để quản lý quyền truy cập và thông tin liên hệ, trong đó quan trọng nhất là:
- Email liên hệ của API Google Ads: Đây là email được liệt kê là 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 tài khoản người quản lý Google Ads: Đây là (những) email có quyền quản trị đối với (các) tài khoản người quản lý Google Ads mà bạn truy cập thông qua API Google Ads. Khi tạo mã thông báo làm mới cho ứng dụng, bạn thường xác thực ứng dụng API Google Ads bằng một trong những email này.
Bạn nên sử dụng bí danh nhóm dùng chung để không 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 đổi 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 trình bày chi tiết về từng email được liệt kê ở trên 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 một người dùng cá nhân.
Email liên hệ về API Google Ads
Email liên hệ của API Google Ads là địa chỉ email mà bạn cung cấp khi đăng ký API Google Ads. Bạn nên đảm bảo quyền truy cập vào bí danh này và thường xuyên theo dõi 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 trường hợp khẩn cấp trong quá trình phát hành công khai cần được chú ý ngay lập tức. Sử dụng bí danh chung của nhóm làm email liên hệ để đảm bảo rằng toàn bộ nhóm nhận được các 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:
Đăng nhập vào Tài khoản người quản lý của bạn trên Google Ads.
Nhấp vào Quản trị ở dưới cùng bên trái màn hình.
Trong phần 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 ghi lại email liên hệ của 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 chỉ định một tên đại diện 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 của dự án trên Google API Console:
- Đăng nhập vào Google API Console.
- Chọn dự án của bạn trong trình đơn thả xuống ở góc trên cùng bên trái của trang.
- Chuyển đến phần IAM and admin > IAM (Quản trị viên và IAM) trên trình đơn bên trái.
- Nhấp vào nút Cấp quyền truy cập.
- Nhập địa chỉ email dùng chung trong mục Thêm người đại diện.
- Chỉ định vai trò Chủ sở hữu.
- Nhấp vào nút Lưu. Hãy tham khảo tài liệu về Cloud để tìm hiểu thêm về cách 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 pháp phổ biến để quản lý tài khoản bằng API Google Ads 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 xác thực 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ã thông báo làm mới bằng thông tin xác thực của một 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_idlàm mã khách hàng của tài khoản người quản lý Google Ads và tiêu đềcustomer_idlà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ã thông báo làm mới sẽ không còn hợp lệ và tất cả lệnh gọi API 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 thích hợp. Sử dụng bí danh email dùng chung này để phát hành mã thông báo làm mới nhằm thực hiện lệnh gọi API.