Mỗi mã của nhà phát triển Google Ads API đượ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. 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ã của nhà phát triển được phép sử dụng.
Cấp truy cập
Có 4 cấp truy cập mã của nhà phát triển được liệt kê theo thứ tự trong bảng. Nếu chưa có quyền truy cập Google Ads API, bạn có thể bắt đầu bằng cách đăng ký để nhận mã của nhà phát triển có Cấp truy cập 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... | Giới hạn thao tác hằng ngày1 | Cách đăng ký | Thông thường, quy trình xem xét mất bao lâu? |
|---|---|---|---|---|
| Cấp truy cập 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 | |
| Cấp truy cập của người khám phá | Tài khoản thử nghiệm và tài khoản sản xuất | 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 thử nghiệm |
Hướng dẫn | |
| Cấp truy cập cơ bản | Tài khoản thử nghiệm và tài khoản sản xuất | 15.000 thao tác / ngày đối với cả tài khoản thử nghiệm và tài khoản sản xuất | Hướng dẫn | 2 ngày làm việc |
| Cấp truy cập thông thường | Tài khoản thử nghiệm và tài khoản sản xuất | Không giới hạn số thao tác / ngày đối với cả tài khoản thử nghiệm và tài khoản sản xuất | Hướng dẫ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à 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.
Cấp truy cập tài khoản thử nghiệm
Sau khi bạn hoàn tất quy trình đăng ký ban đầu cho Google Ads API, bạn sẽ được cấp một mã của nhà phát triển có 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ể đưa ra các yêu cầu Google Ads API đối với tài khoản thử nghiệm.
Cách đăng ký Cấp truy cập tài khoản thử nghiệm
Hoàn tất quy trình đăng ký Google Ads API trên giao diện web Google Ads để tự động được cấp Cấp truy cập tài khoản thử nghiệm.
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, trong một số trường hợp, Google có thể tự động nâng cấp mã của nhà phát triển từ Cấp truy cập tài khoản thử nghiệm lên Cấp truy cập của người khám phá. Cấp truy cập Explorer 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 sản xuất. 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ủa người khám phá cho phép mã của nhà phát triển thực hiện tối đa 2.880 thao tác mỗi ngày đối với tài khoản sản xuất. Số lượng này đủ để hầu hết các nhà phát triển bắt đầu sử dụng API và xây dựng quy trình tự động hoá cơ bản.
Cấp truy cập của 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 những 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 thông thường.
| 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 |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Thanh toán và thanh toán tài khoản |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Cách đăng ký Cấp truy cập của người khám phá
Hoàn tất quy trình đăng ký API Google Ads trên giao diện web Google Ads. Trong một số trường hợp, Google có thể tự động nâng cấp mã của nhà phát triển lê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ý.
Cấp truy cập cơ bản
Cấp 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 sản xuất. 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 hiện tối đa 15.000 thao tác mỗi ngày. Số lượng này đủ cho hầu hết các nhà phát triển.
Cách đăng ký Cấp truy cập cơ bản
Nếu có mã của nhà phát triển có Cấp truy cập tài khoản thử nghiệm hoặc Cấp truy cập của người khám phá, bạn có thể đăng ký Cấp truy cập cơ bản như sau:
Truy cập vào https://ads.google.com/aw/apicenter trong trình duyệt web. Đăng nhập vào tài khoản người quản lý Google Ads nếu được nhắc.
Xác minh rằng Cấp truy cập của bạn là Tài khoản thử nghiệm hoặc Người khám phá.
Đả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ó đị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 với tài khoản người quản lý Google Ads có mã API.
Nhấp vào mũi tên thả xuống bên cạnh Cấp truy cập rồi nhấp vào đường liên kết Đăng ký Cấp truy cập cơ bản.
Cấp truy cập thông thường
Cấp 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 Cấp truy cập thông thường, 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 cần số lượng thao tác API Google Ads không giới hạn, chẳng hạn như các công ty lớn hoặc công cụ phục vụ nhiều người dùng.
Cách đăng ký Cấp truy cập thông thường
Nếu có mã của nhà phát triển có Cấp truy cập cơ bản, bạn có thể đăng ký Cấp truy cập thông thường như sau:
Truy cập vào https://ads.google.com/aw/apicenter trong trình duyệt web. Đăng nhập vào tài khoản người quản lý Google Ads nếu được nhắc.
Xác minh rằng Cấp truy cập của bạn là Cơ bản.
Đả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ó đị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 với tài khoản người quản lý Google Ads có mã API.
Nhấp vào mũi tên thả xuống bên cạnh Cấp truy cập rồi nhấp vào đường liên kết Đăng ký Cấp truy cập thông thường.
Nếu công cụ của bạn được người dùng bên ngoài sử dụng, hãy chuẩn bị cung cấp quyền truy cập bản dùng thử để đăng nhập 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.
Hạn mức API và hạn mức về giá của hệ thống
Bất kể cấp truy cập là gì, tất cả các thao tác API đều phải tuân theo hạn mức về giá của hệ thống. Hạn mức 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 hạn mức về giá, hãy xem các loại lỗi.
Các dịch vụ riêng lẻ có thể thực thi các giới hạn và hạn mức bổ sung do những lý do như giới hạn 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.
Mục đích sử dụng được phép
Mục đích sử dụng được phép chỉ áp dụng cho mã của nhà phát triển có Cấp truy cập cơ bản và Cấp truy cập thông thường. 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. Những quyền này xác định những tính năng của API mà mã của nhà phát triển có thể sử dụng, 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ỉ đưa ra các yêu cầu GoogleAdsService.Search
hoặc GoogleAdsService.SearchStream
hoặc các lệnh gọi chỉ đọc. Điều 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ã của nhà phát triển 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ụ yêu cầu đề xuất để giúp tạo và quản lý chiến dịch Google Ads dễ dàng hơn.
|
Cách thay đổi mục đích sử dụng được phép
Nếu mã của nhà phát triển đã được phê duyệt cho Cấp truy cập cơ bản hoặc Cấp truy cập thông thường, bạn có thể điền vào đơn đăng ký để cập nhật mục đích 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 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.