Yêu cầu gửi đến ReachPlanService phải cung cấp 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. Ngoài ra, dự án trên đám mây của Google Cloud liên kết với thông tin đăng nhập OAuth của bạn phải được phê duyệt để sử dụng dịch vụ này.
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 hướng dẫn này.
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 số dự án trên đám mây Google Cloud của mình vào danh sách cho phép thích hợp để kết nối với
ReachPlanService, ngay cả khi số dự án đó đã đượ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, hãy xem đ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 mã khách hàng mà bạn có thể truy vấn trong
ReachPlanService. Điều này giúp bạn nắm được thông tin về quá trình tích hợp 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 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 mục tiêu và thông tin xác thực OAuth được uỷ 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 thiết lập một tài khoản khách hàng cụ thể để chạy chiến dịch.
Công cụ nội bộ
Nếu bạn xây dựng công cụ để sử dụng nội bộ trong tổ chức của mình, hãy cân nhắc các lựa chọn sau:
- 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 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 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 gửi yêu cầu đế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. - Nhà lập kế hoạch có quyền truy cập vào tài khoản khách hàng: Nếu nhà 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 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 nhà lập kế hoạch. Sau đó, bạn có thể chuyển mã khách hàng tương ứng với gói của khách hàng.
Công cụ bên ngoài
Nếu bạn xây dựng công cụ cho người dùng bên thứ ba hoặc người dùng bên ngoài, bạn nên sử dụng các lựa chọn sau:
- 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 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. Đị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 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 cho công cụ của bạn quyền truy cập vào tài khoản của họ bằ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để truy xuất danh sách các tài khoản Google Ads mà họ có thể truy cập.
Trước khi tích hợp API, hãy chọn một trong các phương pháp trước đó dựa trên yêu cầu về hệ thống của bạn và xác định một vài mã khách hàng thử nghiệm. Nếu bạn không chắc chắn, hãy bắt đầu bằng quy trình xác thực một người dùng với các tài khoản được liên kết.
Bước tiếp theo
Tìm hiểu cách chỉ định kế hoạch truyền thông.