Dự án trên đám mây của bạn trên Google Cloud đượ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 sản xuất 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 quyền truy cập cấp Tài khoản thử nghiệm cho dự án trên đám mây của mình. 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 thao tác hằng ngày 1 | Cách đăng ký | Quá trình xem xét thường mất bao lâu? |
|---|---|---|---|---|
| Cấp truy cập vào tài khoản 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 tài khoản kiểm thử | |
| Cấp truy cập của người khám phá | Tài khoản kiểm thử và tài khoản phát hành công khai | 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ấp truy cập cơ bản | Tài khoản kiểm thử và tài khoản phát hành công khai | 15.000 thao tác / ngày cho cả tài khoản thử nghiệm và tài khoản chính thức | Đăng ký quyền truy cập cơ bản | |
| Cấp truy cập thông thường | Tài khoản kiểm thử và tài khoản phát hành công khai | 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.
Cấp truy cập vào tài khoản thử nghiệm
Sau khi bạn bật Google Ads API, dự án trên đám mây của bạn sẽ được cấp quyền truy cập ở cấp Tài khoản thử nghiệm. Điều này có nghĩa là dự án chỉ có thể đưa ra các yêu cầu Google Ads API đối với tài khoản thử nghiệm.
Đăng ký cấp truy cập vào Tài khoản kiểm thử
Bật Google Ads API trong dự án trên đám mây của Google để tự động được cấp quyền truy cập ở cấp Tài khoản thử nghiệm 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 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 Explorer cho phép dự án trên đám mây Google Cloud của bạn thực hiện tối đa 2.880 thao tác mỗi ngày đối với các tài khoản sản xuất. Điều này là đủ để hầu hết các nhà phát triển bắt đầu sử dụng API và tạo quy trình 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 quyền truy cập để yêu cầu cấp độ truy cập là 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 truy cập Explorer 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 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 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 truy 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 trên đám mây 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 được áp dụng ngay cả khi dự án của bạn có cấp độ Truy cập tiêu chuẩn.
Cấp truy cập 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 API Google Ads, 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ý cấp truy cập thông thường
- 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ó cấp truy cập Chuẩn.
Ứng dụng Quyền truy cập thông thường bao gồm 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 bản trình diễn vào công cụ của bạn. 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 đơn đăng ký Quyền truy cập tiêu chuẩn. Sau 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, mọi 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 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 giới hạn và hạn mức 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 và độ trễ của API. 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.
Hoạt động 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 độ Quyền 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. Những 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 | Cung 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 để giúp tạo và quản lý các chiến dịch trên Google Ads. |
Thay đổi phạm vi sử dụng cho phép
Nếu dự án trên đám mây của bạn trên Google Cloud đã được phê duyệt cho cấp truy cập tiêu chuẩn, bạn có thể điền vào đơn đăng ký để cập nhật việc 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.