Dự án trên đám mây của Google Cloud của bạn được chỉ định một cấp truy cập và "mục đích sử dụng được phép". Cấp truy cập xác định xem bạn có thể ảnh hưởng đến tài khoản phát hành công khai hay không, cũng như số lượng thao tác và yêu cầu mà bạn có thể thực hiện hằng ngày. Cách sử dụng hợp lệ xác định những tính năng cụ thể của Google Ads API mà dự án được phép sử dụng.
Cấp truy cập
Có 4 cấp độ truy cập API khác nhau được liệt kê theo thứ tự trong bảng. Nếu chưa có quyền truy cập vào Google Ads API, bạn có thể bắt đầu bằng cách bật API để có được cấp truy cập Kiểm thử cho dự án trên đám mây của Google. Bạn có thể tăng cấp độ truy cập bằng cách hoàn tất một số bước bổ sung trong ứng dụng.
| Cấp truy cập | Có thể truy cập vào... | Giới hạn giao dịch hằng ngày 1 | Cách đăng ký | Quá trình xem xét thường mất bao lâu? |
|---|---|---|---|---|
| Thử nghiệm | Tài khoản kiểm thử | 15.000 thao tác / ngày | Đăng ký quyền truy cập vào phiên bản thử nghiệm | |
| Trình khám phá | Tài khoản thử nghiệm và tài khoản sản xuất | 2.880 thao tác / ngày đối với tài khoản sản xuất 15.000 thao tác / ngày đối với tài khoản kiểm thử |
Đăng ký quyền truy cập của người khám phá | |
| Cơ bản | Tài khoản thử nghiệm và tài khoản sản xuất | 15.000 thao tác / ngày cho cả tài khoản thử nghiệm và tài khoản sản xuất | Đăng ký quyền truy cập cơ bản | |
| Chuẩn | Tài khoản thử nghiệm và tài khoản sản xuất | Không giới hạn số lượng thao tác / ngày cho cả tài khoản kiểm thử và tài khoản thực | Đăng ký quyền truy cập tiêu chuẩn | 10 ngày làm việc |
1 "Mỗi ngày" dựa trên khoảng thời gian 24 giờ liên tục mà các yêu cầu API được thực hiện bằng dự án trên đám mây của Google. Ứng dụng của bạn sẽ gặp lỗi nếu vượt quá giới hạn yêu cầu cho cấp độ truy cập của bạn trong vòng 24 giờ qua.
Quyền truy cập để kiểm thử
Sau khi bạn bật Google Ads API, dự án Google Cloud của bạn sẽ được cấp quyền truy cập Kiểm thử. Điều này có nghĩa là dự án chỉ có thể gửi các yêu cầu Google Ads API đối với tài khoản kiểm thử.
Đăng ký quyền truy cập vào phiên bản thử nghiệm
Bật Google Ads API trong dự án Google Cloud để tự động được cấp quyền truy cập Kiểm thử cho dự án của bạn.
Cấp truy cập của người khám phá
Sau khi bạn hoàn tất quy trình đăng ký ban đầu cho Google Ads API, Google có thể cho phép bạn đăng ký cấp truy cập Explorer.
Cấp truy cập Explorer cho phép dự án Google Cloud của bạn thực hiện các yêu cầu Google Ads API đối với cả tài khoản kiểm thử và tài khoản sản xuất. Tài khoản sản xuất là những tài khoản phân phát quảng cáo thực sự, đang hoạt động trên Google – tài khoản kiểm thử không phân phát quảng cáo.
Cấp truy cập Explorer cho phép dự án trên đám mây của Google thực hiện tối đa 2.880 thao tác mỗi ngày đối với tài khoản phát hành công khai. Điều này là đủ để hầu hết các nhà phát triển bắt đầu sử dụng API và xây dựng hệ thống tự động hoá cơ bản.
Cấp truy cập Người khám phá hạn chế quyền truy cập vào các tính năng sau. Nếu cần sử dụng các tính năng này, bạn cần đăng ký Cấp truy cập cơ bản hoặc Cấp truy cập tiêu chuẩn.
| Chức năng bị hạn chế | Dịch vụ và phương thức bị hạn chế |
|---|---|
| Tạo tài khoản | CustomerService.CreateCustomerClient |
| Quản lý người dùng | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Lập kế hoạch | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Thanh toán và lập hoá đơn cho tài khoản | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Đăng ký cấp truy cập Người khám phá
- Chuyển đến trang Tổng quan về Google Ads API trong dự án Google Cloud của bạn.
- Xác minh rằng trang này hiển thị cấp truy cập hiện tại của bạn là Kiểm thử.
- Nhấp để mở rộng phần Nâng cấp cấp độ truy cập.
- Xác nhận rằng Cấp truy cập tiếp theo hiển thị là Người khám phá.
- Nhấp vào nút Yêu cầu cấp quyền truy cập để yêu cầu cấp quyền truy cập của Người khám phá.
Google có thể tự động nâng cấp cấp truy cập API của dự án lên cấp Khám phá sau khi bạn gửi đơn đăng ký.
Cấp truy cập cơ bản
Cấp truy cập Cơ bản cho phép dự án trên đám mây của Google Cloud thực hiện các yêu cầu Google Ads API đối với cả tài khoản thử nghiệm và tài khoản sản xuất. Tài khoản sản xuất là những tài khoản phân phát quảng cáo thực tế, đang hoạt động trên Google – tài khoản kiểm thử không phân phát quảng cáo.
Cấp truy cập Cơ bản cho phép dự án trên đám mây Google Cloud của bạn thực hiện tối đa 15.000 thao tác mỗi ngày. Điều này là đủ cho hầu hết các nhà phát triển.
Đăng ký cấp truy cập Cơ bản
- Chuyển đến trang Tổng quan về Google Ads API trong dự án Google Cloud của bạn.
- Xác minh rằng trang này hiển thị cấp truy cập hiện tại của bạn là Người khám phá.
- Nhấp để mở rộng phần Nâng cấp cấp độ truy cập.
- Xác nhận rằng Cấp truy cập tiếp theo hiển thị là Cơ bản.
- Xác nhận rằng không có cảnh báo nào cho biết bạn chưa hoàn tất quy trình xác minh thương hiệu cho dự án của mình. Nếu có, hãy làm theo hướng dẫn để hoàn tất quy trình xác minh thương hiệu trước khi tiếp tục.
- Nhấp vào nút Đăng ký quyền truy cập để đăng ký cấp truy cập Cơ bản.
Google có thể tự động nâng cấp cấp truy cập API của dự án lên cấp Cơ bản sau khi bạn gửi đơn đăng ký.
Cấp truy cập thông thường
Cấp truy cập tiêu chuẩn cho phép dự án Google Cloud của bạn thực hiện số lượng thao tác không giới hạn mỗi ngày cho tất cả các dịch vụ. Các dịch vụ và tính năng riêng lẻ vẫn có thể có hạn mức và quy định hạn chế về tốc độ dành riêng cho những tính năng đó. Các hạn mức và quy định hạn chế này sẽ tiếp tục áp dụng ngay cả khi dự án của bạn có cấp truy cập Tiêu chuẩn.
Quyền truy cập tiêu chuẩn chỉ được cấp cho những nhà phát triển cần thực hiện không giới hạn các thao tác Google Ads API, chẳng hạn như các công ty lớn hoặc những công cụ phục vụ nhiều người dùng.
Đăng ký quyền truy cập tiêu chuẩn
- Chuyển đến trang Tổng quan về Google Ads API trong dự án Google Cloud của bạn.
- Xác minh rằng trang này hiển thị cấp truy cập hiện tại của bạn là Cơ bản.
- Nhấp để mở rộng phần Nâng cấp cấp độ truy cập.
- Xác nhận rằng Cấp truy cập tiếp theo hiển thị là Tiêu chuẩn.
- Nhấp vào nút Start application (Bắt đầu ứng dụng) để bắt đầu ứng dụng cấp truy cập Chuẩn.
Ứng dụng có quyền truy cập tiêu chuẩn sẽ trải qua quy trình kiểm tra thủ công chi tiết đối với ứng dụng của bạn. Hãy chuẩn bị sẵn sàng để trả lời các câu hỏi về chức năng của công cụ và đối tượng mục tiêu của công cụ đó. Nếu người dùng bên ngoài sử dụng công cụ của bạn, hãy chuẩn bị sẵn sàng để cung cấp quyền truy cập đăng nhập dùng thử cho công cụ đó. Xin lưu ý rằng công cụ của bạn phải tuân thủ Chức năng tối thiểu bắt buộc.
Trong suốt quá trình xem xét, Nhóm tuân thủ của Google sẽ liên hệ với bạn qua địa chỉ email của bạn. Hãy nhớ phản hồi kịp thời các câu hỏi của nhóm Tuân thủ để tiến hành xử lý đơn đăng ký quyền truy cập tiêu chuẩn của bạn. Khi quá trình xem xét hoàn tất, Google sẽ gửi email cho bạn để thông báo kết quả cuối cùng của quy trình xem xét.
Hạn mức API và hạn mức tốc độ hệ thống
Bất kể cấp truy cập, tất cả các thao tác API đều phải tuân theo giới hạn tốc độ của hệ thống. Giới hạn này hạn chế số lượng thao tác mà bạn có thể thực hiện trong một khoảng thời gian, tức là số lượng thao tác mỗi giờ. Để tìm hiểu thêm về cách xử lý lỗi giới hạn về tốc độ, hãy xem các loại lỗi.
Các dịch vụ riêng lẻ có thể áp dụng thêm các hạn mức và hạn chế về hạn ngạch do những lý do như hạn chế về thiết kế sản phẩm, hạn chế về chính sách sản phẩm, hiệu suất API và các yếu tố về độ trễ. Hãy xem tài liệu về hạn mức API để tìm hiểu thêm về những hạn chế này.
Sử dụng được phép
Việc sử dụng được phép chỉ áp dụng cho các dự án trên Google Cloud có cấp độ truy cập Tiêu chuẩn. Mức sử dụng hợp lệ được phân bổ dựa trên mục đích sử dụng Google Ads API. Các quyền này xác định những tính năng của API mà công cụ của bạn có thể sử dụng, như được trình bày chi tiết trong bảng sau:
| Sử dụng được phép | Mô tả |
|---|---|
| Tạo / quản lý quảng cáo | Cấp quyền truy cập vào tất cả các dịch vụ của API để tạo và quản lý chiến dịch, nhóm quảng cáo, quảng cáo và từ khoá trên Google Ads. |
| Báo cáo | Chỉ thực hiện các yêu cầu GoogleAdsService.Search hoặc GoogleAdsService.SearchStream hoặc các lệnh gọi chỉ đọc. Đây là dành cho những nhà phát triển chỉ sử dụng API để yêu cầu số liệu thống kê. |
| Nghiên cứu từ khoá và đề xuất | Cho phép dự án trên Google Cloud truy cập vào RecommendationService, KeywordPlanIdeaService và KeywordPlanService. Thông tin này chỉ được dùng bởi những công cụ cần đề xuất để hỗ trợ việc tạo và quản lý chiến dịch trên Google Ads. |
Thay đổi cách sử dụng được phép
Nếu dự án của bạn trên Google Cloud đã được phê duyệt cho cấp truy cập Chuẩn, bạn có thể điền vào đơn đăng ký để cập nhật mục đích sử dụng được phép. Điền vào biểu mẫu đăng ký nếu bạn muốn cập nhật mục đích sử dụng cho phép hoặc cấp cho khách hàng quyền truy cập vào công cụ của bạn.