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

Lưu ý: Google chấp nhận các đơn đăng ký sớm tham gia chương trình này, dự kiến ra mắt vào cuối năm 2023. Đăng ký

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

• Không cần phải bảo mật mã của nhà phát triển nữa: Quyền truy cập vào 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 mã của nhà phát triển hoặc việc rò rỉ mã đó. 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 Google API cho các ứng dụng khác nhau: Mọi dự án được liên kết trong tổ chức Google Cloud đều kế thừa cấp truy cập vào API của tổ chức. Điều này cho phép bạn tạo nhiều dự án Google API Console trong tổ chức này cho các mục đích như quản lý dự án chi tiết, riêng dự án cho nhiều ứng dụng và nhiều dự án Google API Console cho các thành viên trong nhóm.

• Theo dõi và quản lý hạn mức tinh vi hơn: Bạn có thể theo dõi 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ã của người phát triển được phê duyệt để sử dụng phương án này. Bạn có thể tìm thấy mã của nhà phát triển hiện có trên trang Trung tâm API của tài khoản người quản lý Google Ads. Đăng nhập, sau đó chuyển đến CÔNG CỤ VÀ CÀI ĐẶT > THIẾT LẬP > Trung tâm API.

• Một tổ chức trên 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ã này để xác định các cấp truy cập API của bạn. Có nhiều cách để tạo một tổ chức trên Google Cloud.

  Trường hợp	Các bước
  Bạn đang là khách hàng của Google Workspace hoặc Google Cloud Identity	Có khả năng là bạn đã sở hữu một tài nguyên tổ chức. Bạn có thể Kiểm tra và tạo một tài khoản 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 của bạn.
  Không có tuỳ chọn nào ở trên phù hợp với bạ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 một tài nguyên tổ chức cho bạn. Google sẽ sở hữu và quản lý miễn phí tài nguyên của tổ chức này.

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

  Bạn cần chuẩn bị các dự án trên Bảng điều khiển API của Google 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 trên Google Cloud hoặc đã tạo một tổ chức ở 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 sản đó trong tổ chức. Nếu bạn đang là khách hàng của Google Workspace hoặc Google Cloud Identity, thì có thể các dự án trong Google API Console đã thuộc tổ chức của bạn nên bạn có thể bỏ qua bước này.
  Bạn không sở hữu tổ chức nào trên Google Cloud và không thể tạo tổ chức này ở 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à dự án Google API Console của bạn. Bạn cần có 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ủa bạn được phê duyệt.

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

  Hãy đảm bảo rằng email liên hệ của bạn về API Google Ads là mới nhất. Thông tin liên hệ về API của bạn được liệt kê trên trang Trung tâm API trong tài khoản người quản lý API Google Ads. Hãy đăng nhập, sau đó chuyển đến CÔNG CỤ VÀ 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 này. Sau đó, nhóm Tuân thủ của Google sẽ xem xét đơn đăng ký của bạn và gửi thông tin về trạng thái phê duyệt và các thông tin bổ sung qua email cho địa chỉ email liên hệ của API.

Nếu đã yêu cầu Google tạo một tổ chức trên Google Cloud cho bạn, bạn cần thực hiện thêm vài bước:

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

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

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 để di chuyển dự án Google API Console trong tổ chức mới.

4. 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 email đến địa chỉ email liên hệ API để cho biết trạng thái phê duyệt và thông tin bổ sung.

Sửa đổi các 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 nên thực hiện. Nếu bạn đang tham gia chương trình thí điểm, máy chủ API Google Ads sẽ bỏ qua developer-token nếu được gửi như một phần của các yêu cầu API.

Java

Sắp ra mắt!

.NET

Tải và cài đặt thư viện.NET API Google Ads phiên bản 17.1 .0 trở lên.

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.
...

1.199

Sắp ra mắt!

Python

Sắp ra mắt!

Ruby

Sắp ra mắt!

Perl

Sắp ra mắt!

Máy khách HTTP (REST)

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

curl -i -X POST https://googleads.googleapis.com/v17/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 thì mới có thể sử dụng API Google Ads phải không?

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

Tôi cần thay đổi cấp truy cập API của mình. 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 mọi thay đổi đối với các cấp truy cập API.

Thời gian ngừng hoạt động để chọn tham gia chương trình thí điểm này có phải là thời gian ngừng hoạt động 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 API này được phê duyệt.

Có mất nhiều công sức để tham gia chương trình thí điểm này không?

Có thể thay đổi mã ở mức tối thiểu. Hầu hết nhà phát triển sẽ có thể hoàn tất các thay đổi cho ứng dụng của họ trong vòng chưa đầy 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 sẽ không thực hiện bất kỳ thay đổi nào đối với mô hình đặt giá API Google Ads.

Sau đây là các trường hợp có thể có để được thành lập tổ chức Google Cloud:

1. Bạn đang là khách hàng của Google Workspace hoặc Google Cloud Identity:

   Bạn sẽ bị tính 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 trên Google Cloud để tham gia chương trình thí điểm này.

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

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

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

   Đây là tài nguyên nội bộ của tổ chức trên Đám mây do Google quản lý, do đó, bạn sẽ không bị tính phí.

Tôi có nhiều mã của nhà phát triển cho các công cụ khác nhau. 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 vào chương trình thí điểm này.

Điều này có ảnh hưởng đến bất kỳ hoạt động uỷ quyền API hiện có nào đối với những 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ỳ hoạt động uỷ quyền API nào hiện có đối với những 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à gặp vấn đề hoặc 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 bằng cách sử dụng trang hỗ trợ kỹ thuật API và giải thích bản chất của vấn đề. Hãy cung cấp các thông tin chi tiết như mã tổ chức, yêu cầu và nhật ký phản hồi của bạn nếu có thể.