Mỗi mã thông báo 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 cho 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. Mục đích sử dụng được phép xác định những tính năng cụ thể của Google Ads API mà mã thông báo nhà phát triển được phép sử dụng.
Cấp truy cập
Bảng này liệt kê 3 cấp truy cập theo thứ tự. 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 vào... | 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 thử | 15.000 thao tác / ngày | Hướng dẫn |
| Quyề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 |
| Truy cập 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ố lượng 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ờ liên tục mà 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ẽ gặp lỗi nếu vượt quá hạn mức 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 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 với cấp truy cập Tài khoản thử nghiệm. Điều này có nghĩa là mã thông báo 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 kiểm thử.
Cách đăng ký quyền truy cập vào tài khoản kiểm thử
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.
Quyền truy cập cơ bản
Cấp truy cập cơ bản cho phép mã thông báo nhà phát triển đưa ra 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 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, đ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ã thông báo nhà phát triể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.
Cách đăng ký Quyền truy cập cơ bản
Nếu bạn có mã thông báo nhà phát triển với 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 sản xuất, hãy điền vào biểu mẫu đăng ký Quyền truy cập cơ bản. Đả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 độ Quyền truy cập vào tài khoản thử nghiệm.
- Đảm bảo rằng Email liên hệ qua API trong trung tâm API luôn đượ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 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 của mình với tài khoản người quản lý bằng mã thông báo API.
Truy cập chuẩn
Cấp truy cập tiêu chuẩn cho phép mã thông báo 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 cho 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 cấp 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 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.
Bất kể cấp truy cập nào, 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 tốc độ, hãy xem phần Các loại lỗi.
Cách đăng ký quyền truy cập thông thường
Nếu bạn có mã thông báo nhà phát triển ở cấp Truy cập cơ bản và muốn đăng ký sử dụng không giới hạn các thao tác API Google Ads, hãy điền vào biểu mẫu đăng ký cấp 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ị 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.
Việc sử dụng được phép
Việc sử dụng được phép chỉ áp dụng cho mã thông báo nhà phát triển có cấp độ Quyền truy cập cơ bản và Quyền truy cập tiêu chuẩn. Mức sử dụng cho 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 những tính năng của API mà mã thông báo nhà phát triển có thể dùng, như 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 mã thông báo truy cập vào RecommendationService, KeywordPlanIdeaService và KeywordPlanService. Tham số này chỉ được dùng bởi những công cụ yêu cầu đề xuất để giúp tạo và quản lý các chiến dịch trên Google Ads. |
Cách thay đổi mục đích sử dụng được phép
Nếu mã thông báo nhà phát triển của bạn đã được phê duyệt cho cấp độ Quyền truy cập cơ bản hoặc Quyền truy cập tiêu 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 đơn đăng ký nếu bạn muốn cập nhật phạm vi 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.