Thiết lập dự án Google API Console

Bạn cần có một dự án trong Bảng điều khiển API của Google để tạo thông tin đăng nhập OAuth 2.0, định cấu hình màn hình lấy sự đồng ý của người dùng và bật API Google Ads cho ứng dụng của mình.

Thông tin đăng nhập là thông tin cần thiết để máy chủ của Google xác thực và uỷ quyền cho người dùng Google Ads. Những thông tin đăng nhập này cho phép bạn tạo mã thông báo OAuth để sử dụng trong các lệnh gọi đến API.

Chọn hoặc tạo một dự án Google API Console

Nếu đã có dự án Google API Console và muốn sử dụng dự án đó để tạo thông tin đăng nhập, bạn có thể chuyển đến phần Tạo mã ứng dụng khách và mật khẩu ứng dụng khách.

Cách tạo dự án:

  • Chuyển đến Google API Console
  • Nhấp vào Tạo dự án
  • Nhập tên hoặc chấp nhận đề xuất đã tạo
  • Xác nhận hoặc chỉnh sửa các trường còn lại
  • Nhấp vào Tạo

Nếu bạn đã bật tính năng thanh toán, hãy chọn một tài khoản thanh toán cho dự án mới. Bạn không phải trả phí để sử dụng API Google Ads, nhưng có hạn mức đối với tổng số dự án trên Google Cloud.

Nếu đang sử dụng một dự án Google API Console hiện có và đã định cấu hình màn hình xin phép bằng OAuth, thì bạn có thể bỏ qua bước này và sửa đổi màn hình xin phép bằng cách thêm phạm vi OAuth 2.0 của API Google Ads.

Khi bạn sử dụng OAuth 2.0 để uỷ quyền, Google sẽ hiển thị cho người dùng màn hình xin phép, bao gồm cả bản tóm tắt về dự án, các chính sách của dự án và phạm vi uỷ quyền truy cập mà Google yêu cầu. Việc định cấu hình màn hình xin phép bằng OAuth của ứng dụng sẽ xác định nội dung mà người dùng và người đánh giá ứng dụng nhìn thấy, đồng thời đăng ký ứng dụng của bạn để bạn có thể phát hành sau.

  1. Mở trang Màn hình đồng ý và chọn dự án của bạn trong trình đơn thả xuống ở đầu trang.
  2. Chọn Loại người dùng rồi nhấp vào TẠO.
  3. Điền vào biểu mẫu màn hình xin phép. Bạn có thể chỉnh sửa thông tin này sau nếu cần. Nhấp vào LƯU VÀ TIẾP TỤC khi hoàn tất.
  4. Trên trang tiếp theo, hãy nhấp vào THÊM HOẶC XOÁ PHẠM VI.
  5. Di chuyển xuống rồi nhập nội dung sau vào trường trong phần Thêm phạm vi theo cách thủ công:

    https://www.googleapis.com/auth/adwords

  6. Nhấp vào THÊM VÀO BẢNG.
  7. Thêm bất kỳ phạm vi nào khác mà dự án của bạn có thể cần, sau đó nhấp vào CẬP NHẬT.
  8. Nhấp vào LƯU VÀ TIẾP TỤC.
  9. Nếu bạn không có kế hoạch xuất bản dự án ngay lập tức, hãy thêm địa chỉ email của từng tài khoản người dùng mà bạn có thể sử dụng để kiểm thử, sau đó nhấp vào LƯU VÀ TIẾP TỤC.
  10. Xem lại trang tóm tắt rồi nhấp vào QUAY LẠI TRANG TỔNG QUAN.
  1. Mở trang Màn hình đồng ý và chọn dự án của bạn trong trình đơn thả xuống ở đầu trang.
  2. Nhấp vào CHỈNH SỬA ỨNG DỤNG.
  3. Nhấp vào LƯU VÀ TIẾP TỤC trên biểu mẫu màn hình xin phép bằng OAuth.
  4. Trên trang tiếp theo, hãy nhấp vào THÊM HOẶC XOÁ PHẠM VI.
  5. Di chuyển xuống rồi nhập nội dung sau vào trường trong phần Thêm phạm vi theo cách thủ công:

    https://www.googleapis.com/auth/adwords

  6. Nhấp vào THÊM VÀO BẢNG.
  7. Nhấp vào LƯU VÀ TIẾP TỤC.
  8. Nhấp vào LƯU VÀ TIẾP TỤC trên biểu mẫu Người dùng thử nghiệm.
  9. Xem lại trang tóm tắt rồi nhấp vào QUAY LẠI TRANG TỔNG QUAN.

Tạo mã ứng dụng khách và mật khẩu ứng dụng khách

Bạn có thể bỏ qua bước này nếu đang sử dụng một dự án hiện có trên Google API Console đã có mã ứng dụng khách và khoá bí mật được tạo.

Sau khi bạn xác định loại ứng dụng của mình, hãy làm theo hướng dẫn bên dưới để tạo mã ứng dụng khách OAuth 2.0 và mật khẩu ứng dụng khách:

  1. Mở trang Thông tin xác thực. Chọn dự án đã tạo trước đây hoặc tạo dự án mới.

  2. Trên màn hình Thông tin xác thực, hãy nhấp vào TẠO CREDENTIALS, sau đó chọn client ID (Mã ứng dụng khách OAuth).

    • Nếu trước đây bạn chưa định cấu hình màn hình xin phép bằng OAuth cho dự án này, hãy nhấp vào CẤU cấu hình MÀN HÌNH ĐỒNG Ý.

      • Chọn loại người dùng rồi nhấp vào TẠO.

      • Điền vào biểu mẫu ban đầu. Bạn có thể chỉnh sửa thông tin này sau nếu cần. Nhấp vào Lưu khi hoàn tất.

    • Hãy quay lại phần Credentials > CREATE CREDENTIALS > OAuth client ID (Thông tin xác thực > TẠO CREDENTIALS > Mã ứng dụng khách OAuth) để tiếp tục.

  3. Chọn Desktop app (Ứng dụng cho máy tính) hoặc Web application (Ứng dụng web) làm loại ứng dụng, tuỳ thuộc vào trường hợp sử dụng của bạn. Hướng dẫn này sử dụng loại ứng dụng là Ứng dụng dành cho máy tính.

  4. Điền tên cho ứng dụng, sau đó nhấp vào Create (Tạo).

  5. Trên trang xác nhận, sao chép Mã ứng dụng khách của bạnMật khẩu ứng dụng khách của bạn vào bảng nhớ tạm để định cấu hình thư viện ứng dụng sau này. Ngoài ra, hãy tải thông tin xác thực ở định dạng JSON xuống tệp có tên credentials.json.

Bật API Google Ads trong dự án

Để bật API Google Ads trong dự án, hãy làm theo các bước sau:

  1. Mở Thư viện API trong Google API Console. Nếu được nhắc, hãy chọn dự án của bạn hoặc tạo một dự án mới. Thư viện API liệt kê tất cả các API có sẵn, được nhóm theo nhóm sản phẩm và mức độ phổ biến.

  2. Hãy sử dụng tính năng tìm kiếm để tìm API Google Ads nếu API này không xuất hiện trong danh sách.

  3. Chọn API Google Ads, rồi nhấp vào nút Bật.