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 xác thực 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 đề cập đến thông tin xác thực dành riêng cho ReachPlanService. Trước tiên, hãy hoàn tất các bước nêu trong phần Bắt đầu nếu bạn chưa làm như vậy, sau đó quay lại điểm này.
Mã của nhà phát triển và thông tin xác thực 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 thì bạn mới có thể kết nối với
ReachPlanService, ngay cả khi mã đó đã được phê duyệt để sử dụng với các dịch vụ khác của API Google Ads. Để biết thêm thông tin, hãy xem các yêu cầu về điều kiện sử dụng. - 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 sẽ xác định mã khách hàng mà bạn có thể truy vấn trong
ReachPlanService. Điều này cung cấp thông tin cho việc tích hợp của bạn và được giải thích chi tiết hơn ở bên dưới.
ID Khách hàng
Hầu hết dịch vụ trong API Google Ads đều hoạt động trên các tài khoản và chiến dịch Google Ads cụ thể. Do đó, hầu hết các yêu cầu đều cần có 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 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ông cụ để sử dụng nội bộ trong tổ chức của mình, họ nên sử dụng một trong các lựa chọn sau:
Nếu người lập kế hoạch 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 luồng ứ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. Sau đó, hãy tạo hoặc lấy tài khoản Google Ads cho từng 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ý. Khi đưa ra yêu cầu tới
ReachPlanService, hãy cung 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 một 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 của bạn sử dụng thông tin xác thực OAuth của trình 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 trong gói của bạn.
Đối với những đối tác xây dựng công cụ cho người dùng bên ngoài, chúng tôi đề xuất các phương pháp tương tự:
Tạo thông tin xác thực OAuth bằng luồng ứ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. Tạo 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ọ tạo kế hoạch.
Giú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 luồng ứ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 tài khoản Google Ads mà họ có thể truy cập.
Mục tiêu là để đảm bảo những người lập kế hoạch gặp ít phiền hà nhất có thể khi sử dụng ReachPlanService. Trước khi tích hợp API, hãy chọn một trong hai 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 đầu tiên được đề xuất cho loại công cụ của bạn.