Cấp truy cập do đám mây quản lý

Lưu ý: Google đang nhận đơn đăng ký tham gia chương trình này. Đăng ký.

Tính năng này cho phép tổ chức Google Cloud quản lý các cấp truy cập API của bạn, mang lại cho bạn các lợi ích sau:

• Không cần bảo mật mã thông báo nhà phát triển nữa: Quyền truy cập API được quản lý thông qua tổ chức Google Cloud, vì vậy, bạn không còn phải lo lắng về việc bảo mật hoặc rò rỉ mã thông báo nhà phát triển nữa. Bạn có thể bỏ qua việc gửi mã của nhà phát triển trong các lệnh gọi API, mặc dù bạn vẫn cần gửi mã truy cập.

• Duy trì các dự án riêng biệt trên Bảng điều khiển API của Google cho nhiều ứng dụng: Mọi dự án được liên kết trong tổ chức Google Cloud đều kế thừa cấp truy cập API của tổ chức đó. Điều này cho phép bạn tạo nhiều dự án Bảng điều khiển API Google trong tổ chức này cho các mục đích như quản lý dự án chi tiết, các dự án riêng biệt cho nhiều ứng dụng và nhiều dự án Bảng điều khiển API Google cho các thành viên trong nhóm.

• Giám sát và quản lý hạn mức chi tiết hơn: Bạn có thể giám sát mức sử dụng API của từng dự án hoặc giới hạn mức sử dụng API.

Điều kiện tiên quyết

• Mã của nhà phát triển đã được phê duyệt

  Bạn phải có mã thông báo nhà phát triển đã được phê duyệt thì mới có thể sử dụng tuỳ chọn này. Bạn có thể tìm thấy mã của nhà phát triển hiện có trong Trung tâm API trong tài khoản người quản lý Google Ads. Đăng nhập, sau đó chuyển đến Quản trị > Trung tâm API. Trong Trung tâm API, hãy chuyển đến Quyền truy cập API > Mã thông báo dành cho nhà phát triển.

• Một tổ chức Google Cloud

  API Google Ads liên kết mã của nhà phát triển với một tổ chức Google Cloud và sử dụng mã đó để xác định cấp truy cập API của bạn. Có nhiều cách để tạo tổ chức Google Cloud.

  Trường hợp	Các bước
  Bạn là khách hàng hiện tại của Google Workspace hoặc Google Cloud Identity	Có thể bạn đã sở hữu một tài nguyên của tổ chức. Bạn có thể Kiểm tra và tạo một nếu cần.
  Bạn không sử dụng Google Workspace hoặc Google Cloud Identity	Đăng ký phiên bản miễn phí của Google Cloud Identity. Sau đó, hãy tạo tài nguyên tổ chức.
  Bạn không dùng được phương án nào ở trên	Giải thích trường hợp của bạn khi bạn đăng ký tham gia chương trình thí điểm và yêu cầu Google tạo tài nguyên tổ chức cho bạn. Google sẽ sở hữu và quản lý tài nguyên này của tổ chức mà không tính phí.

• Chuẩn bị dự án trên Google API Console cho chương trình thí điểm

  Bạn cần chuẩn bị các dự án Google API Console mà bạn sử dụng với API Google Ads cho chương trình thí điểm như sau:

  Trường hợp	Các bước
  Bạn đã sở hữu một tổ chức Google Cloud hoặc đã tạo một tổ chức trong bước trước	Đảm bảo rằng tất cả các dự án trên Google API Console mà bạn đã bật API Google Ads đều thuộc tổ chức này. Nếu không, hãy di chuyển tài khoản đó vào tổ chức. Nếu là khách hàng hiện tại của Google Workspace hoặc Cloud Identity của Google, thì có thể các dự án trong Google API Console đã thuộc tổ chức của bạn. Vì vậy, bạn có thể bỏ qua bước này.
  Bạn không sở hữu tổ chức Google Cloud và không thể tạo tổ chức trong bước trước	Đảm bảo rằng bạn vừa là người dùng quản trị trên tài khoản người quản lý API Google Ads vừa là người dùng quản trị trên dự án Google API Console. Bạn cần quyền này để thực hiện các bước bổ sung sau khi đơn đăng ký chương trình thí điểm được phê duyệt.

• Email liên hệ mới nhất về API

  Đảm bảo rằng email liên hệ của bạn cho API Google Ads là email mới nhất. Thông tin liên hệ của bạn về API được liệt kê trên trang API Center của tài khoản người quản lý API Google Ads. Đăng nhập, sau đó chuyển đến CÔNG CỤ & CÀI ĐẶT > THIẾT LẬP > Trung tâm API.

Đăng ký tham gia chương trình thí điểm

Đăng ký tham gia chương trình thí điểm. Sau đó, Nhóm tuân thủ của Google sẽ xem xét đơn đăng ký của bạn và gửi email cho địa chỉ email liên hệ của API để thông báo trạng thái phê duyệt và các thông tin chi tiết khác.

Nếu bạn đã yêu cầu Google tạo một tổ chức Google Cloud cho bạn, thì bạn cần thực hiện thêm một số bước sau:

1. Google sẽ tạo một tài nguyên tổ chức trên Cloud do Google sở hữu cho bạn. Tất cả quản trị viên của tài khoản người quản lý API Google Ads sẽ được cấp vai trò roles/resourcemanager.projectCreator trên tổ chức mới tạo.

2. Google sẽ gửi email đến địa chỉ email liên hệ API của bạn kèm theo thông tin chi tiết về tài nguyên tổ chức mới tạo.

3. Bạn cần đăng nhập vào tài khoản Google API Console và làm theo hướng dẫn để chuyển dự án Google API Console sang tổ chức mới.

4. Hãy trả lời email để cho Google biết rằng các dự án của bạn đã được chuyển sang tổ chức mới.

5. Nhóm tuân thủ của Google sẽ xem xét đơn đăng ký của bạn và gửi trạng thái phê duyệt cùng thông tin chi tiết bổ sung qua email liên hệ API của bạn.

Sửa đổi yêu cầu API

Bạn có thể sửa đổi ứng dụng để ngừng gửi tiêu đề developer-token khi thực hiện lệnh gọi API. Đây là bước không bắt buộc nhưng bạn nên thực hiện. Nếu bạn đang tham gia chương trình thí điểm, thì máy chủ API Google Ads sẽ bỏ qua developer-token nếu được gửi trong các yêu cầu API.

Java

Sắp có!

.NET

Tải xuống và cài đặt phiên bản 17.1.0 trở lên của thư viện Google Ads API .NET.

Tiếp theo, hãy sửa đổi mã của bạn như sau:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

Sắp có!

Python

Sắp có!

Ruby

Sắp có!

Perl

Sắp có!

Ứng dụng khách HTTP (REST)

Bỏ qua tiêu đề developer-token trong các yêu cầu HTTP:

curl -i -X POST https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Câu hỏi thường gặp

Thay đổi này có nghĩa là tôi cần phải là khách hàng của Google Workspace hoặc Google Cloud để sử dụng API Google Ads không?

Không. Bạn cần có một tổ chức trên Google Cloud. Bạn có thể tạo tổ chức theo nhiều cách. Yêu cầu này tương tự như việc bạn cần có một dự án trong Google API Console để sử dụng API Google Ads hiện nay.

Tôi cần thay đổi Cấp truy cập API. Làm cách nào để thực hiện việc này?

Hiện tại, bạn nên tiếp tục sử dụng Trung tâm API để yêu cầu thay đổi đối với cấp truy cập API.

Có thời gian ngừng hoạt động nào khi chọn tham gia chương trình thí điểm này không?

Không, không có cách nào như vậy. API Google Ads sẽ tự động bắt đầu sử dụng các cấp truy cập API cấp tổ chức sau khi được phê duyệt.

Tôi cần phải làm gì để tham gia chương trình thí điểm này?

Dự kiến thay đổi mã ở mức tối thiểu. Hầu hết các nhà phát triển đều có thể hoàn tất việc thay đổi ứng dụng trong vòng chưa đến 30 phút.

Tôi có bị tính phí nếu chọn tham gia chương trình thí điểm này không?

Nhìn chung, bạn sẽ không bị tính phí nếu chọn tham gia chương trình thí điểm này. API Google Ads được cung cấp miễn phí và Google không thực hiện thay đổi nào đối với mô hình định giá của API Google Ads.

Sau đây là các trường hợp có thể xảy ra khi bạn nhận được một tổ chức Google Cloud:

1. Bạn là khách hàng hiện tại của Google Workspace hoặc Google Cloud Identity:

   Bạn sẽ phải trả phí như bình thường cho mọi hoạt động sử dụng thông thường của các sản phẩm đó. Bạn sẽ không bị tính phí khi tạo một tổ chức Google Cloud để tham gia chương trình thí điểm này.

2. Bạn đã tạo tài khoản phiên bản miễn phí của Google Cloud Identity:

   Bạn sẽ không bị tính phí khi đăng ký tài khoản phiên bản miễn phí của Google Cloud Identity hoặc khi tạo một tổ chức Google Cloud để tham gia chương trình thí điểm này.

3. Google đã tạo một tài nguyên tổ chức trên Cloud cho bạn:

   Đây là tài nguyên tổ chức nội bộ trên Google Cloud do Google quản lý, vì vậy, bạn sẽ không bị tính phí.

Tôi có nhiều mã thông báo nhà phát triển cho nhiều công cụ. Chương trình thí điểm này ảnh hưởng như thế nào đến tôi?

Trường hợp sử dụng này không được hỗ trợ nên bạn sẽ không thể tham gia chương trình thí điểm này.

Việc này có ảnh hưởng đến bất kỳ quyền uỷ quyền API hiện có nào đối với các tài khoản mà tôi quản lý bằng API Google Ads không?

Không, thay đổi này không ảnh hưởng đến bất kỳ quyền uỷ quyền API hiện có nào đối với các tài khoản Google Ads mà bạn quản lý bằng API Google Ads.

Tôi đã chọn tham gia chương trình thí điểm này và có vấn đề hoặc ý kiến phản hồi. Làm cách nào để liên hệ với nhóm hỗ trợ?

Liên hệ với nhóm API Google Ads thông qua trang hỗ trợ kỹ thuật về API và giải thích bản chất của vấn đề. Cung cấp thông tin chi tiết như mã nhận dạng tổ chức, nhật ký yêu cầu và phản hồi nếu có thể.