Mỗi mã của nhà phát triển API Google Ads đượ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 chính thức hay không, cũng như số lượng thao tác và yêu cầu mà bạn có thể thực thi mỗi ngày. Mục đích sử dụng được phép xác định các tính năng cụ thể của API Google Ads mà mã thông báo nhà phát triển được phép sử dụng.
Cấp truy cập
Có 3 cấp truy cập 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 API Google Ads, bạn có thể bắt đầu bằng cách đăng ký để có quyền truy cập vào tài khoản thử nghiệm. 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... | Giới hạn hoạt động hằng ngày1 | Áp dụng |
|---|---|---|---|
| Quyền truy cập vào tài khoản thử nghiệm | Tài khoản thử nghiệm | 15.000 thao tác / ngày | Hướng dẫn |
| Truy cập cơ bản | Tài khoản thử nghiệm và tài khoản chính thức | 15.000 thao tác / ngày | Hướng dẫn |
| Quyền truy cập tiêu chuẩn | Tài khoản thử nghiệm và tài khoản chính thức | Không giới hạn số thao tác / ngày | Hướng dẫn |
1 "Mỗi ngày" dựa trên khoảng thời gian 24 giờ lăn, trong đó các yêu cầu API được thực hiện bằng mã thông báo nhà phát triển của bạn. Ứng dụng của bạn sẽ nhận được lỗi nếu vượt quá giới hạn yêu cầu đối với cấp truy cập của bạn trong vòng 24 giờ qua.
Quyền truy cập vào tài khoản thử nghiệm
Sau khi hoàn tất quy trình đăng ký ban đầu cho API Google Ads, bạn sẽ được cấp một mã của nhà phát triển có cấp truy cập vào tài khoản thử nghiệm. Điều này có nghĩa là mã của nhà phát triển chỉ có thể tạo các yêu cầu API Google Ads đối với tài khoản thử nghiệm.
Đăng ký quyền truy cập vào tài khoản thử nghiệm
Hoàn tất quy trình đăng ký API Google Ads trên giao diện web của Google Ads để tự động được cấp cấp truy cập tài khoản thử nghiệm.
Truy cập cơ bản
Quyền truy cập cơ bản cho phép mã của nhà phát triển đưa ra các yêu cầu API Google Ads đối với cả tài khoản thử nghiệm và tài khoản chính thức. Tài khoản chính thức là mọi tài khoản phân phát quảng cáo thực tế của Google. Tài khoản thử nghiệm không phân phát quảng cáo.
Cấp truy cập cơ bản cho phép mã thông báo nhà phát triển thực thi 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ý quyền truy cập cơ bản
Nếu bạn có mã của nhà phát triển cấp truy cập tài khoản thử nghiệm và muốn đăng ký quyền truy cập vào tài khoản chính thức, hãy điền vào biểu mẫu đăng ký quyền truy cập cơ bản. Hãy đảm bảo bạn đã hoàn tất các bước sau:
- Đảm bảo rằng bạn đã có mã thông báo nhà phát triển có cấp truy cập vào tài khoản thử nghiệm.
- Đảm bảo rằng Email liên hệ về API trong trung tâm API đã được cập nhật. Bạn phải đăng nhập vào tài khoản người quản lý để xem trung tâm API. Bạn sẽ không thể hoàn tất quy trình đăng ký nếu không có địa chỉ email hợp lệ và thường xuyên được kiểm tra. Đảm bảo bạn đã liên kết tất cả tài khoản Google Ads đang hoạt động với tài khoản người quản lý bằng mã thông báo API.
Quyền truy cập tiêu chuẩn
Quyền truy cập tiêu chuẩn cho phép mã thông báo nhà phát triển thực thi số lượng thao tác không giới hạn mỗi ngày đối với hầu hết các dịch vụ. Các tệp này bao gồm nhưng không giới hạn ở GoogleAdsService Search và SearchStream. Để biết thêm thông tin chi tiết về các giới hạn và trường hợp ngoại lệ đối với quyền truy cập tiêu chuẩn, hãy xem phần Hạn mức API.
Cấp truy cập tiêu chuẩn chỉ được cấp cho những nhà phát triển yêu cầu các hoạt động không giới hạn trên API Google Ads, chẳng hạn như các công cụ hoặc công ty lớn phục vụ nhiều người dùng.
Bất kể cấp truy cập, tất cả thao tác API đều tuân theo giới hạn tốc độ hệ thống. Để tìm hiểu thêm về cách xử lý lỗi giới hạn tốc độ, hãy xem phần Các loại lỗi.
Đăng ký quyền truy cập thông thường
Nếu bạn hiện có cấp truy cập cơ bản và muốn đăng ký thực hiện số lượng thao tác không giới hạn trên API Google Ads, hãy điền vào biểu mẫu đăng ký quyền truy cập tiêu chuẩn.
Nếu công cụ của bạn là bên ngoài, hãy chuẩn bị để cung cấp quyền đăng nhập minh hoạ 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.
Mục đích sử dụng được phép
Quyền sử dụng được phép chỉ áp dụng cho quyền truy cập cơ bản và mã thông báo truy cập tiêu chuẩn. Mục đích sử dụng được phép được phân bổ dựa trên mục đích sử dụng API Google Ads. Các quyền này xác định tính năng nào của API có thể sử dụng mã thông báo, như được trình bày chi tiết trong bảng sau:
| Mục đích 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ó thể đọc. API này 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 mã thông báo truy cập vào RecommendationService, KeywordPlanIdeaService và KeywordPlanService. Mã này chỉ được các công cụ yêu cầu đề xuất sử dụng để hỗ trợ việc tạo và quản lý chiến dịch trên Google Ads. |
Thay đổi mục đích sử dụng được phép
Nếu đã được phê duyệt cấp truy cập cơ bản hoặc cấp truy cập tiêu chuẩn, bạn có thể điền vào biểu mẫu 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 được 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.