Các yêu cầu đối với ReachPlanService phải cung cấp mã thông báo 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 chi tiết về quy trình 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 tất các bước được nêu trong phần Bắt đầu, sau đó quay lại bước này.
Mã thông báo 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:
- Bạn phải thêm mã của nhà phát triển vào danh sách cho phép thích hợp để kết nối với
ReachPlanService, ngay cả khi mã này đã đượ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 của bạn sẽ xác định những mã khách hàng mà bạn có thể truy vấn trong
ReachPlanService. Điều này sẽ cung cấp thông tin cho quá trình tích hợp của bạn và được giải thích chi tiết hơn trong các phần sau.
ID Khách hàng
Hầu hết các dịch vụ trong API Google Ads đều hoạt động trên các tài khoản và chiến dịch cụ thể trên Google Ads. Do đó, hầu hết các yêu cầu đều cần cả mã khách hàng để xác định tài khoản mà 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 được dùng cho các hoạt động lập kế hoạch video có thể diễn 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.
Công cụ nội bộ
Nếu bạn tạo các công cụ để sử dụng nội bộ trong tổ chức của mình, thì sau đây là các đề xuất của chúng tôi.
Người lập kế hoạch không có quyền truy cập trực tiếp vào tài khoản khách hàng
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 đăng nhập 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ý mã thông báo nhà phát triển của bạn. Sau đó, hãy tạo hoặc lấy 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 các tài khoản đó với tài khoản người quản lý của bạn. Khi đưa ra yêu cầu đối vớ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.
Nhà lập kế hoạch có quyền truy cập vào tài khoản khách hà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 đăng nhập OAuth của người lập kế hoạch. Sau đó, bạn có thể truyền mã nhận dạng khách hàng tương ứng với khách hàng của gói.
Công cụ bên ngoài
Nếu tạo 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ự:
Mỗi tài khoản khách hàng
Tạo thông tin đăng nhập 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ý mã thông báo nhà phát triển của bạn. 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 các tài khoản đó 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ụ để cung cấp mã khách hàng tương ứng của khách hàng khi họ tạo kế hoạch.
Quyền truy cập do người dùng cấp
Cho phép người dùng cấp quyền truy cập vào tài khoản của họ cho công cụ của bạn 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 tài khoản Google Ads mà họ có thể truy cập.
Mục tiêu là đảm bảo người lập kế hoạch có thể sử dụng ReachPlanService một cách dễ dàng nhất có thể. 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ã nhận dạng khách hàng để kiểm thử. Nếu không chắc chắn, 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.
Bước tiếp theo
Tìm hiểu cách Chỉ định kế hoạch truyền thông.