Tính năng này cho phép một 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 những lợi ích sau:
Không còn cần bảo mật mã của nhà phát triển: Quyền truy cập API được quản lý thông qua tổ chức trên Google Cloud, vì vậy, bạn không còn cần phải lo lắng về việc bảo mật hoặc làm rò rỉ mã của nhà phát triển. 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 Google API Console cho các ứng dụng khác nhau: Mọi dự án được liên kết trong tổ chức trên 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 trê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, các dự án riêng biệt cho các ứng dụng khác nhau và nhiều dự án trên Google API Console cho các thành viên trong nhóm của bạn.
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ã của nhà phát triển đã được phê duyệt để 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 phần Quản trị viên > Trung tâm API. Trong Trung tâm API, hãy chuyển đến phần Quyền truy cập API > Mã của nhà phát triển.
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 trên 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 tổ chức trên 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 Rất có thể 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 nguyê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. Không có lựa chọn nào ở trên phù hợp với bạn Hãy giải thích trường hợp của bạn khi đăng ký 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 tổ chức này miễn phí. Chuẩn bị các 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 trên Google API Console mà bạn sử dụng với Google Ads API 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 Google Ads API đều nằm trong tổ chức này. Nếu không, hãy di chuyển dự án đó vào tổ chức. Nếu bạn là khách hàng hiện tại của Google Workspace hoặc Google Cloud Identity, rất có thể các dự án trên Google API Console đã nằm trong 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 trên Google Cloud và không thể tạo một tổ chức ở bước trước Đảm bảo rằng bạn vừa là người dùng quản trị viên trên tài khoản người quản lý Google Ads API vừa là dự án trên Google API Console. Bạn cần có quyền này để thực hiện các bước khác sau khi đơn đăng ký chương trình thí điểm của bạn được phê duyệt. Email liên hệ API mới nhất
Đảm bảo rằng email liên hệ Google Ads API của bạn là email mới nhất. Thông tin liên hệ API của bạn được liệt kê trên trang Trung tâm API của tài khoản người quản lý Google Ads API. Đăng nhập, sau đó chuyển đến phần CÔNG CỤ VÀ CÀI ĐẶT > THIẾT LẬP > Trung tâm API.
Đăng ký chương trình thí điểm
Đăng ký chương trình thí điểm. 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 của bạn để thông báo trạng thái phê duyệt và thông tin bổ sung.
Nếu bạn yêu cầu Google tạo tổ chức trên Google Cloud cho bạn, thì bạn cần thực hiện thêm một số bước nữa:
Google sẽ tạo 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ý Google Ads API sẽ được cấp vai trò
roles/resourcemanager.projectCreatortrên tổ chức mới tạo.Google sẽ gửi email đến địa chỉ email liên hệ API của bạn để cung cấp thông tin chi tiết về tài nguyên tổ chức mới tạo.
Bạn phải đă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 trên Google API Console vào tổ chức mới.
Trả lời email để cho Google biết rằng các dự án của bạn đã được di chuyển vào tổ chức mới.
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 của bạn để thông báo trạng thái phê duyệt và thông tin bổ sung.
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 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 ra mắt!
.NET
Tải xuống và cài đặt thư viện Google Ads API.NET 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.
...
PHP
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)
Bỏ qua tiêu đề developer-token trong các yêu cầu HTTP:
curl -i -X POST https://googleads.googleapis.com/v24/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
Dưới đây là một số câu hỏi thường gặp về các cấp truy cập do Cloud quản lý.
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 một tổ chức trên Google Cloud. Bạn có thể nhận được tổ chức này 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 trên Google API Console để sử dụng Google Ads API hiện nay.
Tôi cần thay đổi các cấp truy cập API. Tôi phải làm gì?
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 các 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ó thời gian ngừng hoạt động nào. 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 bỏ ra bao nhiêu công sức để tham gia chương trình thí điểm này?
Bạn chỉ cần thay đổi mã ở mức tối thiểu. Hầu hết nhà phát triển đều có thể hoàn tất việc thay đổi ứng dụng 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 không thay đổi mô hình giá của API Google Ads.
Sau đây là các trường hợp có thể xảy ra để bạn có thể nhận được tổ chức trên Google Cloud:
Bạn là khách hàng hiện tại 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ác sản phẩm đó. Bạn sẽ không bị tính phí khi tạo tổ chức trên Google Cloud cho mục đích tham gia chương trình thí điểm này.
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 tổ chức trên Google Cloud cho mục đích tham gia chương trình thí điểm này.
Google đã tạo tài nguyên tổ chức trên Cloud cho bạn:
Đây là tài nguyên tổ chức trên Cloud nội bộ do Google quản lý, vì vậy, 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 đến tôi như thế nào?
Trường hợp sử dụng này không được hỗ trợ, vì vậy, bạn sẽ không thể tham gia chương trình thí điểm này.
Điều 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 Google Ads API 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 Google Ads API.
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 trang hỗ trợ kỹ thuật API và giải thích bản chất vấn đề của bạn. Hãy cung cấp thông tin chi tiết như mã tổ chức và nhật ký yêu cầu và phản hồi nếu có thể.