API Search Ads 360 yêu cầu tất cả các yêu cầu chỉ định một mã truy cập OAuth 2.0 để xác thực. Bạn có thể làm theo mọi quy trình xác thực OAuth 2.0 tiêu chuẩn để tạo mã thông báo và chuyển mã đó tới API Search Ads 360. Quy trình làm việc được mô tả dưới đây là phù hợp vì nó phù hợp với tính năng tự động tải lượt chuyển đổi lên và tải báo cáo xuống.
Để biết các giải pháp thay thế cho quy trình làm việc được mô tả bên dưới, hãy xem phần Sử dụng OAuth 2.0 cho ứng dụng đã cài đặt hoặc Sử dụng OAuth 2.0 cho ứng dụng từ máy chủ đến máy chủ. Nếu bạn sử dụng quy trình làm việc thay thế,
hãy chỉ định giá trị sau làm thông số scope khi bạn yêu cầu mã uỷ quyền
OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Nếu bạn đi theo máy chủ đến tuyến máy chủ, hãy thêm tài khoản dịch vụ làm người dùng Search Ads 360.
Quy trình uỷ quyền đề xuất
- Chuyển đến Google API Console rồi chọn dự án của bạn.
Nếu bạn chưa tạo dự án Google API Console và thông tin đăng nhập OAuth, hãy làm theo hướng dẫn trong bài viết Tạo dự án Google API Console và thông tin đăng nhập OAuth cho ứng dụng.
Để tìm mã ứng dụng khách OAuth và mã thông báo bí mật của dự án, hãy làm như sau:
- Mở trang Thông tin xác thực.
- Trong cột Tên, hãy nhấp vào tên của ứng dụng OAuth.
- Mã khách hàng và mã bí mật được liệt kê trên trang.
- Mở trình duyệt web và đăng nhập vào Google bằng Tài khoản Google có quyền truy cập vào dữ liệu trong Search Ads 360.
Đây là Tài khoản Google mà ứng dụng API của bạn sẽ sử dụng để xác thực bằng Search Ads 360. Nếu chủ Tài khoản Google rời khỏi công ty của bạn và bạn xóa quyền truy cập của Search Ads 360 khỏi tài khoản, thì bạn sẽ cần lặp lại quy trình ủy quyền này và chỉ định một Tài khoản Google khác.
- Lấy mã làm mới bằng cách gọi tập lệnh tiện ích Search Ads 360 như sau:
sa360Api.py --loginTập lệnh sẽ hướng dẫn bạn cách sử dụng mã ứng dụng khách OAuth và mã thông báo bí mật để lấy mã làm mới. Mã làm mới chỉ hợp lệ đối với Tài khoản Google mà bạn đã đăng nhập trong bước trước đó.
Trong quá trình này, tập lệnh sẽ tạo một URL và hướng dẫn bạn truy cập URL đó trong trình duyệt web.
-
Khi trình duyệt yêu cầu bạn cho phép ứng dụng OAuth truy cập vào dữ liệu Search Ads 360, hãy đảm bảo Tài khoản Google bạn đã đăng nhập trước đó sẽ xuất hiện. (Nếu đã đăng nhập vào nhiều Tài khoản Google, thì bạn có thể thấy một tài khoản khác.)
Vào cuối quá trình, tập lệnh
sa360Api.pysẽ xuất ra một chuỗi được phân tách bằng dấu phẩy. Giá trị đầu tiên là mã ứng dụng khách bạn đã cung cấp, giá trị thứ hai là mã ứng dụng khách bí mật mà bạn đã cung cấp và giá trị thứ ba là mã làm mới. Trong kết quả ví dụ sau, mã làm mới có văn bản in đậm:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw - Lưu trữ mã ứng dụng khách, mật khẩu ứng dụng khách và mã làm mới trong cơ sở dữ liệu phụ trợ hoặc vị trí bảo mật khác mà ứng dụng của bạn có thể truy cập.
Giữ toàn bộ chuỗi được phân tách bằng dấu phẩy ở một vị trí thuận tiện nếu bạn định sử dụng
sa360Api.pyđể gửi các yêu cầu JSON mẫu tới API Search Ads 360. Bạn sẽ chuyển toàn bộ chuỗi dưới dạng tham số mỗi lần gọi tập lệnh. - Thêm mã vào ứng dụng của bạn để làm những việc sau:
- Sử dụng mã ứng dụng khách, mật khẩu ứng dụng khách và mã làm mới để nhận mã truy cập OAuth 2.0 mới.
- Gửi yêu cầu đến API Search Ads 360 bằng mã truy cập mới.
Nếu bạn đang sử dụng thư viện ứng dụng, phần tiếp theo, Thiết lập ứng dụng, mô tả cách thêm mã uỷ quyền này vào ứng dụng của bạn.
Nếu bạn không sử dụng một trong các thư viện ứng dụng, hãy xem phần Sử dụng OAuth 2.0 cho ứng dụng đã cài đặt để biết các đề xuất lấy mã truy cập mới.