Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Google Ads trong máy chủ Cộng đồng quảng cáo và đo lường của Google.

Trang này được dịch bởi Cloud Translation API.

Cấp truy cập và quyền sử dụng được phép

Mỗi mã thông báo nhà phát triển API Google Ads đề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 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. Cách sử dụng hợp lệ xác định những tính năng cụ thể của API Google Ads mà mã thông báo nhà phát triển được phép sử dụng.

Cấp truy cập

Có 4 cấp truy cập mã thông báo 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 vào API Google Ads, 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 độ 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ày¹	Cách đăng ký	Quá trình 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 kiểm thử	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 kiểm thử và tài khoản chính thức	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 kiểm thử	Hướng dẫn
Cấp truy cập cơ bản	Tài khoản kiểm thử và tài khoản chính thức	15.000 thao tác / ngày cho cả tài khoản thử nghiệm và tài khoản chính thức	Hướng dẫn	2 ngày làm việc
Cấp truy cập tiêu chuẩn	Tài khoản kiểm thử và tài khoản chính thức	Không giới hạn số lượng thao tác / ngày cho 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

¹ "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.

Cấp 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 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 kiểm thử.

Cách đăng ký cấp truy cập vào Tài khoản kiểm thử

Hoàn tất việc đăng ký Google Ads API trên giao diện web của Google Ads để tự động được cấp quyền truy cập ở 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 API Google Ads, trong một số trường hợp, Google có thể tự động nâng cấp mã thông báo nhà phát triển của bạn từ cấp Quyền truy cập vào tài khoản kiểm thử lên cấp Quyền 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ã thông báo nhà phát triển thực hiện 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à những tài khoản phân phát quảng cáo thực tế, đang hoạt động trên Google – tài khoản kiểm thử 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ã thông báo nhà phát triển thực hiện tối đa 2.880 thao tác mỗi ngày đối với các tài khoản thực tế. Điều này là đủ để hầu hết các nhà phát triển bắt đầu sử dụng API và tạo quy trình tự động hoá cơ bản.

Cấp truy cập 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 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	`CustomerUserAccessInvitationService` `CustomerUserAccessService`
Lập kế hoạch	`KeywordPlanService` `KeywordPlanIdeaService` `KeywordPlanCampaignService` `KeywordPlanCampaignKeywordService` `KeywordPlanAdGroupService` `KeywordPlanAdGroupKeywordService` `AudienceInsightsService` `KeywordPlanIdeaService` `ReachPlanService`
Thanh toán và lập hoá đơn cho tài khoản	`PaymentsAccountService` `BillingSetupService` `AccountBudgetProposalService` `InvoiceService`

Cách đăng ký cấp độ truy cập Explorer

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ã thông báo nhà phát triển của bạn lên cấp độ Quyền 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 thực hiện 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ã 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ý cấp truy cập cơ bản

Nếu bạn có mã thông báo nhà phát triển ở cấp quyền truy cập vào Tài khoản kiểm thử 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ý cấp 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 của nhà phát triển với 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ý Google Ads để 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 với tài khoản người quản lý Google Ads có mã thông báo API.

Cấp truy cập tiêu chuẩn

Cấp truy cập 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ề hạn mức và các 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.

Cách đăng ký cấp truy cập thông thường

Nếu bạn có mã của nhà phát triển với cấp truy cập cơ bản và muốn đăng ký số lượng thao tác không giới hạn trên 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 minh hoạ cho 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.

Hạn mức API và giới hạn tốc độ hệ thống

Bất kể cấp độ truy cập, tất cả các thao tác API đều phải tuân theo giới hạn tốc độ của hệ thống. Giới hạn này hạn chế số lượng thao tác 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 giới hạn tốc độ, 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 chế về hạn ngạch do những 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 API và các yếu tố về độ trễ. 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.

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 hợp lệ đượ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à bạn có thể dùng mã thông báo nhà phát triển, 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ã của nhà phát triển 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 để hỗ trợ việc 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ã thông báo dành cho nhà phát triển của bạn đã được phê duyệt cho cấp truy cập Cơ bản hoặc cấp truy cập Chuẩn, thì 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.