Các yêu cầu gửi đến ReachPlanService phải cung cấp mã của nhà phát triển đã được phê duyệt, thông tin đăng nhập OAuth và mã khách hàng mà thông tin đăng nhập OAuth của bạn có thể truy cập.
Hướng dẫn này trình bày thông tin xác thực dành riêng cho ReachPlanService. Nếu bạn chưa thực hiện, trước tiên hãy hoàn thành các bước nêu trong bài viết Bắt đầu, sau đó quay lại bước này.
Mã thông báo của nhà phát triển và thông tin đăng nhập OAuth
Ngoài hướng dẫn trong phần Bắt đầu, hãy lưu ý những điểm sau:
- Mã của nhà phát triển phải nằm trong danh sách cho phép để kết nối với
ReachPlanService, ngay cả khi mã này đã được phê duyệt để sử dụng cùng với các dịch vụ API Google Ads khác. Để biết thêm thông tin, hãy xem các yêu cầu về điều kiện. - Bạn phải chấp nhận Điều khoản dịch vụ của API Google Ads để kết nối với API Google Ads.
- Người dùng sở hữu mã làm mới OAuth của bạn sẽ xác định mã khách hàng mà bạn có thể truy vấn trong
ReachPlanService. Thông tin này giúp bạn quyết định quá trình tích hợp và sẽ được giải thích chi tiết hơn ở bên dưới.
ID Khách hàng
Hầu hết các dịch vụ trong API Google Ads đều hoạt động trên một số tài khoản và chiến dịch Google Ads. Do đó, hầu hết các yêu cầu đều yêu cầu cả mã khách hàng để xác định tài khoản bạn đang quản lý hoặc truy vấn và thông tin xác thực OAuth có quyền truy cập vào mã khách hàng đó. Tuy nhiên, ReachPlanService
dành cho các hoạt động lập kế hoạch cho video có thể xảy ra trước khi bạn biết mã khách hàng cụ thể mà bạn sẽ chạy chiến dịch.
Đối với những đối tác xây dựng các công cụ để sử dụng nội bộ trong tổ chức của mình, bạn nên chọn một trong các lựa chọn sau:
Nếu người lập kế hoạch của bạn không có quyền truy cập vào tài khoản Google Ads của khách hàng: Hãy tạo thông tin xác thực OAuth bằng quy trình đăng ký đã cài đặt cho người dùng có quyền truy cập vào tài khoản người quản lý của mã nhà phát triển. Sau đó, hãy tạo hoặc tạo một tài khoản Google Ads cho mỗi nhóm sử dụng công cụ của bạn và liên kết họ với tài khoản người quản lý của bạn. Khi đưa ra yêu cầu để
ReachPlanServicecung cấp mã khách hàng tương ứng với nhóm của người dùng.Nếu người lập kế hoạch của bạn có quyền truy cập vào tài khoản người quản lý Google Ads để quản lý tài khoản của khách hàng: Hãy triển khai quy trình ứng dụng web để cho phép ứng dụng dùng thông tin xác thực OAuth của người lập kế hoạch. Sau đó, bạn có thể chuyển mã khách hàng tương ứng với khách hàng sử dụng gói của bạn.
Đối với những đối tác xây dựng một công cụ cho người dùng bên ngoài, bạn nên áp dụng các phương pháp tương tự:
Tạo thông tin xác thực OAuth bằng quy trình ứng dụng đã cài đặt cho người dùng có quyền truy cập vào tài khoản người quản lý của mã nhà phát triển. Hãy tạo một tài khoản Google Ads cho mỗi khách hàng bên ngoài và liên kết họ với tài khoản người quản lý của bạn. Sau đó, hãy định cấu hình công cụ của bạn để cung cấp mã khách hàng tương ứng của khách hàng khi họ đang tạo kế hoạch.
Cho phép người dùng cấp cho công cụ của bạn quyền truy cập vào tài khoản của họ bằng cách sử dụng quy trình ứng dụng web. Sau khi người dùng cấp quyền, hãy sử dụng
CustomerServiceđể cung cấp cho họ danh sách các tài khoản Google Ads mà họ có thể truy cập.
Mục tiêu là để đảm bảo rằng những người lập kế hoạch sẽ gặp khó khăn nhất có thể khi sử dụng ReachPlanService. Trước khi tích hợp API, hãy chọn một trong 2 phương pháp tuỳ theo tình huống của bạn và xác định một vài mã khách hàng để kiểm thử. Nếu nghi ngờ, hãy sử dụng phương pháp được đề xuất đầu tiên cho loại công cụ của bạn.