Bí danh dùng chung

Khi làm việc với API Google Ads, có nhiều vị trí mà địa chỉ email được dùng để quản lý thông tin liên hệ và quyền truy cập, trong đó quan trọng nhất là:

  • Email liên hệ về API Google Ads: Đây là email được liệt kê là email liên hệ trong Trung tâm API trên 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 vào tài khoản Google Cloud Console được dùng cho ứng dụng OAuth 2.0.
  • (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ị viên đối với(các) tài khoản Google Ads của 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 của mình bằng một trong các 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 cập nhật email đó để sử dụng email đại diện chung cho nhóm 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ệ về 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 email đại diện này và thường xuyên giám sát các email gửi tới đị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 xảy ra trường hợp sản xuất khẩn cấp cần chú ý ngay. 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 cả nhóm đều 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ý Google Ads mà bạn đã dùng khi đăng ký quyền truy cập vào API Google Ads. Đây cũng chính là tài khoản mà mã của nhà phát triển của bạn được đặt.
  • Chuyển đến Tools & Settings > API Center (Công cụ và cài đặt > Trung tâm API).
  • Nhấp vào mũi tên trong mục 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 Bảng điều khiển API của Google chứa thông tin đăng nhập OAuth của ứng dụng và kiểm soát quyền truy cập vào API Google Ads. Hãy đảm bảo quyền truy cập vào tài khoản này bằng cách đặt bí danh dùng chung làm chủ sở hữu tài khoản.

Làm theo các bước sau để cập nhật chủ sở hữu của dự á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 và quản trị viên > 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 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ý các tài khoản bằng API Google Ads là liên kết tất cả cá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ả cá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 đưa ra mã làm mới bằng cách sử dụ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ực hiện được. Để 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. Hãy sử dụng email đại diện dùng chung này để cấp mã làm mới nhằm thực hiện lệnh gọi API.