Bí danh dùng chung

Khi làm việc với API Google Ads, có nhiều nơi mà địa chỉ email được dùng để quản lý danh bạ và quyền truy cập, 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ị viên đối với tài khoản Google Cloud Console dùng cho ứng dụng OAuth 2.0.
  • (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 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, 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 email đại diện dùng chung của nhóm để 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ước đó và cách bạn có thể cập nhật email đó để sử dụng email đại diện dùng chung của nhóm thay vì địa chỉ email của từng người dùng.

Email liên hệ của 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 phải đảm bảo quyền truy cập vào bí danh này và thường xuyên giám sát các email 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 liên quan đến quá trình sản xuất cần được chú ý ngay lập tức. Hãy sử dụng email đại diện dùng chung của nhóm làm email liên hệ để đảm bảo rằng toàn bộ nhóm đều 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:

  • Đăng nhập vào tài khoản người quản lý Google Ads mà bạn đã sử dụng khi đăng ký quyền truy cập vào API Google Ads. Đây chính là tài khoản chứa mã của nhà phát triển của bạn.
  • Chuyển đến Công cụ và cài đặt > Trung tâm API.
  • Nhấp vào mũi tên bên dưới phần Email liên hệ API.
  • Cập nhật địa chỉ email rồi nhấp vào nút Lưu.

Tài khoản Google Cloud Console

Dự án Google API Console chứa thông tin đăng nhập OAuth của ứng dụng và các biện pháp 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ạo 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 của dự án trên Google API Console:

  • Đăng nhập vào Bảng điều khiển API của Google.
  • 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 và quản trị > 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 phần Thêm người dùng chính.
  • 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ề Đám mây để 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ả các tài khoả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 đưa ra 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 thực hiện lệnh gọi API.

Một rủi ro tiềm ẩn của cá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 không thành công. Để tránh trường hợp này, bạn có thể mời một email đại diện 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 email đại diện được chia sẻ này để gửi mã làm mới nhằm thực hiện lệnh gọi API.