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 những lợi ích sau:
Không cần bảo mật mã thông báo 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 lo lắng về việc bảo mật hoặc làm rò rỉ mã thông báo 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 Bảng điều khiển API của Google 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 API của tổ chức. Nhờ đó, bạn có thể tạo nhiều dự án trên Bảng điều khiển API của 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 trên Bảng điều khiển API của 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 để sử dụng lựa 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 mục Quyền truy cập API > Mã thông báo của nhà phát triển.
Một tổ chức trên Google Cloud
API Google Ads liên kết mã thông báo của nhà phát triển với một tổ chức trên Google Cloud và sử dụng mã thông báo đó để 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 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 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. Không có lựa chọn nào ở trên phù hợp với bạn Giải thích tình huống 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ý tài nguyên tổ chức này mà không tính phí. Chuẩn bị dự án trên Bảng điều khiển API của Google cho chương trình thử nghiệm
Bạn cần chuẩn bị các dự á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ả 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 chưa, hãy di chuyển miề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, thì có thể các dự án trên Google API Console đã nằm trong 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 một 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ị trên tài khoản người quản lý Google Ads API vừa là người dùng quản trị trên dự án Google API Console. 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ử nghiệm của bạn được phê duyệt. Email liên hệ về API mới nhất
Đảm bảo rằng địa chỉ email liên hệ của bạn trong Google Ads API là địa chỉ mới nhất. Thông tin liên hệ về API của bạn có trên trang Trung tâm API của tài khoản người quản lý API Google Ads. Đă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. 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ệ về API của bạn để thông báo trạng thái phê duyệt và 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:
Google sẽ tạo một tài nguyên tổ chức Cloud thuộc sở hữu của Google 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 kèm theo 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 Google API Console sang tổ chức mới.
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.
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ệ về API của bạn để thông báo trạng thái phê duyệt và các thông tin chi tiết khác.
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 các 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 yêu cầu API.
Java
Sắp ra mắt!
.NET
Tải xuống và cài đặt phiên bản 17.1.0 trở lên của thư viện .NET Google Ads API.
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/v20/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
Sau đây là một số câu hỏi thường gặp về cấp truy cập do đám mây 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 có một tổ chức trên Google Cloud. Bạn có thể tạo tổ chức này theo một số cách. Yêu cầu này tương tự như việc bạn cần có một dự án Google API Console để sử dụng API Google Ads hiện tại.
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 mọi thay đổi đối vớ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ó 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.
Bạn cần bỏ ra bao nhiêu công sức để tham gia chương trình thí điểm này?
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 các thay đổi đối với ứng dụng của họ 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 thay đổi mô hình định giá API Google Ads.
Sau đây là các trường hợp có thể xảy ra khi bạn muốn có một 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ủ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.
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 Google Cloud Identity phiên bản miễn phí hoặc khi tạo một tổ chức trên Google Cloud để tham gia chương trình thí điểm này.
Google đã tạo một tài nguyên tổ chức trên Cloud cho bạn:
Đây là một tài nguyên tổ chức nội bộ trên 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 các công cụ khác nhau. Chương trình thử nghiệ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ỳ 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 hiện có nào đố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ử nghiệ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 Google Ads API thông qua trang hỗ trợ kỹ thuật API và giải thích bản chất vấn đề của bạ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à nhật ký phản hồi (nếu có thể).