Authentication

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 xác thực 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 chưa hoàn tất, trước tiên, hãy hoàn thành các bước được nêu trong phần Bắt đầu, sau đó quay lại bước 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 được trình bày trong phần Bắt đầu, hãy lưu ý những điểm sau:

  1. 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ã đó đã được phê duyệt để sử dụng với các dịch vụ khác của Google Ads API. Để biết thêm thông tin, xem các yêu cầu về điều kiện.
  2. 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.
  3. Người dùng sở hữu mã làm mới OAuth 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ẽ thông báo 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 Google Ads API đều hoạt động trên các tài khoản Google Ads và chiến dịch cụ thể của 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, cũng như 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 xây dựng các công cụ để sử dụng nội bộ trong tổ chức, thì đây là những đề xuất của chúng tôi.

Người lập kế hoạch không có quyền truy cập vào tài khoản khách hàng trực tiếp

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 quy trình xác thực một người dùng 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 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 gửi đến ReachPlanService hãy cung cấp mã khách hàng tương ứng với nhóm của người dùng.

Người 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ó 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 xác thực nhiều người dùng để cho phép ứng dụng của bạn sử dụng thông tin xác thực OAuth của người lập kế hoạch. Sau đó, bạn có thể truyền mã khách hàng tương ứng với khách hàng của kế hoạch.

Công cụ bên ngoài

Nếu bạn xây dựng một công cụ cho người dùng bên ngoài, chúng tôi khuyên 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 xác thực OAuth bằng quy trình xác thực một người dùng 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 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 xác thực nhiều người dùng. 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 người lập kế hoạch có mức độ khó khăn thấp nhất có thể khi sử dụng the 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 bạn 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.