Mỗi mã 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ấp truy cập xác định xem bạn có thể ảnh hưởng đến các tài khoản phát hành công khai 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 hay không. Phạm vi 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ó ba 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ý để nhận 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 thử nghiệm | 15.000 hoạt động / ngày | Chỉ dẫn |
| Truy cập cơ bản | Tài khoản thử nghiệm và tài khoản phát hành công khai | 15.000 hoạt động / ngày | Chỉ dẫn |
| Truy cập thông thường | Tài khoản thử nghiệm và tài khoản phát hành công khai | Không giới hạn số lần hoạt động / ngày | Chỉ dẫn |
1 "Mỗi ngày" dựa trên khoảng thời gian 24 giờ trượt, trong đó yêu cầu API được thực hiện bằng mã của nhà phát triển. Ứng dụng sẽ gặp 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ã của nhà phát triển ở cấp truy cập 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ể thực hiện 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 việc đă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 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 các yêu cầu API Google Ads đối với cả tài khoản kiểm thử và tài khoản phát hành công khai. 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 và đang hoạt động của Google – tài khoản thử nghiệm sẽ 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 với hầu hết các nhà phát triển, điều này là đủ.
Đăng ký xin cấp Quyền truy cập cơ bản
Nếu hiện bạ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ý 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ã của nhà phát triển ở cấp truy cập tài khoản thử nghiệm.
- Hãy đảm bảo rằng Email liên hệ API trong trung tâm API là thông tin mới nhất. 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à đượ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 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ụ. Đ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 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 hoạt động API Google Ads không giới hạn, 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 là gì, mọi thao tác API đều phải tuân theo giới hạn tốc độ của hệ thống. Để tìm hiểu thêm về cách xử lý lỗi giới hạn số lượng yêu cầu, hãy xem phần Các loại lỗi.
Đăng ký 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ý hoạt động không giới hạn đối với 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à công cụ bên ngoài, hãy chuẩn bị để cung cấp quyền truy cập đăng nhập minh hoạ vào 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.
Cho phép sử dụng
Việc 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. Các quyền này xác định bạn có thể sử dụng mã thông báo cho những tính năng nào của API, như được nêu chi tiết trong bảng sau:
| Cho phép sử dụng | Nội dung 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ý các 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 yêu cầu GoogleAdsService.Search hoặc GoogleAdsService.SearchStream, hoặc chỉ thực hiện lệnh gọi chỉ đọc. 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 RecommendedService, KeywordPlanIdeaService và KeywordPlanService. Tính năng này chỉ được sử dụng bởi những công cụ yêu cầu đề xuất để tạo điều kiện cho việc tạo và quản lý các chiến dịch trên Google Ads. |
Thay đổi cách sử dụng được phép
Nếu đã được phê duyệt để cấp quyền 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 trường hợp sử dụng được phép. Hãy điền vào đơn đăng ký 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.