Luồng ứng dụng web và máy tính OAuth

Hướng dẫn này sẽ hướng dẫn bạn cách thiết lập OAuth2 để truy cập API bằng thông tin đăng nhập của riêng bạn và luồng máy tính hoặc luồng web.

Tạo thông tin đăng nhập OAuth2 cho một tài khoản

Cách dễ nhất để thực hiện lệnh gọi đến tài khoản API Google Ads là

  1. Liên kết tất cả các tài khoản mà bạn muốn thực hiện lệnh gọi API trong một Tài khoản người quản lý Google Ads duy nhất.

  2. Dùng ví dụ về GenerateUserCredentials để tạo thông tin xác thực OAuth2 cho người dùng có quyền truy cập vào tài khoản người quản lý.

  3. Sử dụng thông tin xác thực OAuth2 để thực hiện lệnh gọi đến tất cả các tài khoản mà bạn cần để quản lý bằng API Google Ads.

Bạn chỉ cần thực hiện các bước này một lần, trừ phi bạn thu hồi, xoá hoặc cần thay đổi phạm vi được phép đối với thông tin xác thực OAuth2.

Bước 1 – Tạo thông tin đăng nhập OAuth2

  1. Làm theo các bước để định cấu hình dự án Bảng điều khiển API của Google cho API Google Ads.

  2. Ghi lại mã ứng dụng khách và bí mật, rồi quay lại trang này.

Bước 2 – Thiết lập thư viện ứng dụng

  1. Trong dòng lệnh, hãy chạy ví dụ GenerateUserCredentials. Quá trình này sẽ nhắc bạn nhập mã ứng dụng khách OAuth2 và khoá bí mật.

    Đây là một ví dụ có tính tương tác, yêu cầu bạn cung cấp thông tin đầu vào.

    dotnet run GenerateUserCredentials.csproj

  2. Ví dụ này sẽ nhắc bạn cung cấp mã ứng dụng khách và bí mật của OAuth2. Cung cấp thông tin chi tiết ở bước 1.

  3. Ví dụ này sẽ tự động mở một URL trong trình duyệt. Nếu bạn chưa đăng nhập vào phiên trình duyệt, trang web sẽ nhắc bạn đăng nhập vào Tài khoản Google. Nếu bạn đã đăng nhập, ứng dụng sẽ bỏ qua lời nhắc đăng nhập và chuyển hướng bạn đến một URL để nhắc bạn cho phép ứng dụng thay mặt bạn truy cập vào tài khoản Google Ads của bạn.

    Màn hình xin phép

  4. Sau đó, bạn sẽ được chuyển đến một trang có thông báo cho biết quá trình uỷ quyền thành công.

    Đã tìm nạp mã làm mới của bạn. Hãy kiểm tra kết quả của bảng điều khiển để biết thêm hướng dẫn.

  5. Quay lại bảng điều khiển nơi bạn đang chạy ví dụ. Ví dụ này chắc hẳn đã hoàn tất và hiển thị mã làm mới của bạn cùng một số hướng dẫn, tiếp theo là các thuộc tính cần thiết để định cấu hình thư viện ứng dụng:

    Copy the following content into your App.config file.

<add key = 'OAuth2Mode' value = 'APPLICATION' />
<add key = 'OAuth2ClientId' value = '******' />
<add key = 'OAuth2ClientSecret' value = '******' />
<add key = 'OAuth2RefreshToken' value = '******' />

Make sure you also set the LOGIN_CUSTOMER_ID header. See
https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
to learn more.

<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />

See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
for alternate configuration options.

Tạo thông tin xác thực OAuth2 cho các ứng dụng tương tác

Nếu không biết trước tài khoản Google Ads cần thực hiện lệnh gọi API, bạn có thể khám phá dịch vụ này trong thời gian chạy bằng cách sử dụng thông tin đăng nhập của người dùng đã đăng nhập trong phiên hoạt động. Hãy xem AuthenticateInAspNetCoreApplication để biết một ví dụ trong đó người dùng hiện đã đăng nhập được xác thực và lấy thông tin đăng nhập OAuth2 trong thời gian chạy.