Mỗi mã của nhà phát triển Google Ads API đều đượ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 thực 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 các 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
Bảng này liệt kê 4 cấp truy cập của mã của nhà phát triển theo thứ tự. Nếu chưa có quyền truy cập vào 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 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... | Giới hạn thao tác hằng ngày1 | Cách đăng ký | Thời gian xem xét thường mất bao lâu? |
|---|---|---|---|---|
| Cấp 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 | |
| Cấp truy cập của người khám phá | Tài khoản thử nghiệm và tài khoản thực tế | 2.880 thao tác / ngày đối với tài khoản thực 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 thực tế | 15.000 thao tác / ngày đối với cả tài khoản thử nghiệm và tài khoản thực tế | Hướng dẫn | 5 ngày làm việc |
| Cấp truy cập tiêu chuẩn | Tài khoản thử nghiệm và tài khoản thực 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 thực 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ờ 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 của bạn trong 24 giờ qua.
Cấp truy cập vào 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ã 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 Google Ads API đối với tài khoản thử nghiệm.
Cách đăng ký Cấp truy cập vào 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 của Google Ads để tự động được cấp Cấp truy cập vào 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 vào 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 của người khám phá 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 thực tế. Tài khoản thực tế là mọi tài khoản phân phát quảng cáo thực tế và đ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 thực tế. Con số này đủ để hầu hết 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 các 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 tiêu chuẩn.
| 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à hoá đơ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 của 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 thực tế. Tài khoản thực tế là mọi tài khoản phân phát quảng cáo thực tế và đ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. Con số này đủ cho hầu hết 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 vào 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:
Chuyển đến Trung tâm API 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ệ về 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à 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.
Hoàn tất quy trình xác minh thương hiệu của dự án Google Cloud
Google Ads API sử dụng trạng thái xác minh thương hiệu của các dự án Google Cloud được liên kết với mã của nhà phát triển trong khi xem xét đơn đăng ký Cấp truy cập cơ bản. Bạn có thể hoàn tất quy trình xác minh thương hiệu trong dự án Google Cloud để đẩy nhanh quy trình xem xét đơn đăng ký cấp truy cập cơ bản. Trong một số trường hợp, Google cũng có thể yêu cầu bạn hoàn tất quy trình xác minh thương hiệu trong các dự án Google Cloud làm điều kiện tiên quyết để xử lý đơn đăng ký cấp truy cập cơ bản. Hãy tham khảo hướng dẫn xác minh thương hiệu để tìm hiểu thêm.
Cấp truy cập tiêu chuẩn
Cấp truy cập tiêu chuẩn 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ụ. Trong đó có
GoogleAdsService Search và
SearchStream nhưng không giới hạn ở các dịch vụ này. Để 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 số lượng thao tác không giới hạn đối với Google Ads API, 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 tiêu chuẩn
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 tiêu chuẩn như sau:
Chuyển đến Trung tâm API 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ệ về 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à 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 tiêu chuẩn.
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 vào bản dùng thử của 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 nào, tất 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 giới hạn 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 về 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ể áp dụng thêm các giới hạn và hạn mức do các lý do như hạn chế 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 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 Google Ads API. Các 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ư 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ả 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.
Chỉ những công cụ yêu cầu đề xuất mới sử dụng tính năng này để giúp tạo và quản lý chiến dịch trên Google Ads.
|
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 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. 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.