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