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 cho quyền truy cập API bằng thông tin đăng nhập của riêng bạn và quy trình trên máy tính hoặc quy trình web. 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.

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. Trước tiên, hãy nhấp vào biểu tượng Tải ứng dụng OAuth xuống để tải tệp JSON của ứng dụng xuống, sau đó nhấp vào nút TẢI JSON XUỐNG trên màn hình tiếp theo.

    Lưu tệp vào thư mục gốc để bạn có tệp cục bộ ~/client_secret_XXX.apps.googleusercontent.com.json (trong đó XXX sẽ là các giá trị dành riêng cho dự án của bạn). Chúng ta sẽ sử dụng tệp này trong bước tiếp theo để chạy mã ví dụ.

Thiết lập thư viện ứng dụng

  1. Trong dòng lệnh, hãy chạy ví dụ GenerateUserCredentials. Sử dụng cờ dòng lệnh để chuyển tệp JSON mà bạn đã tải xuống ở bước trước.

    Để chạy từ dòng lệnh bằng Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. Ví dụ này sẽ nhắc bạn truy cập vào một URL mà tại đó bạn cần cho phép thông tin xác thực OAuth2 thay mặt bạn truy cập vào tài khoản Google Ads của bạn.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
    

    Di chuyển đến URL trong phiên trình duyệt ở chế độ riêng tư hoặc cửa sổ ẩn danh. Đăng nhập bằng chính Tài khoản Google mà bạn dùng để truy cập vào Google Ads. Nhấp vào Tiếp tục trên màn hình xin phép bằng OAuth2.

    Màn hình xin phép

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

    Đã truy xuất thành công mã uỷ quyền.

    Kiểm tra kết quả bảng điều khiển từ GenerateUserCredentials để biết thêm hướng dẫn.

  4. Quay lại bảng điều khiển nơi bạn đang chạy ví dụ. Bạn sẽ thấy ví dụ này đã hoàn tất và đang hiển thị mã làm mới 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:

    #Mon Apr 18 09:07:51 EDT 2022
    api.googleads.refreshToken=1/Yw.........................................
    api.googleads.clientId=...........-...............apps.googleusercontent.com
    api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
    api.googleads.clientSecret=........................
    
  5. Sao chép các dòng từ ghi chú ngày # đến cuối kết quả vào tệp ads.properties.

    Thay thế INSERT_DEVELOPER_TOKEN_HERE bằng mã của nhà phát triển.

    Để thiết lập dễ dàng nhất, hãy đặt tệp ads.properties trong thư mục gốc của bạn.