Bạn cần có một dự án Google API Console để tạo thông tin đăng nhập OAuth 2.0, định cấu hình màn hình xin phép người dùng và bật API Google Ads cho ứng dụng của mình.
Thông tin đăng nhập 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. Các thông tin xác thực này cho phép bạn tạo mã thông báo OAuth để dùng trong các lệnh gọi đến API.
Chọn hoặc tạo dự án Google API Console
Nếu đã có dự án trên Bảng điều khiển API của Google và muốn sử dụng dự án đó để tạo thông tin xác thực, thì 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 một dự án:
- Chuyển đến Bảng điều khiển API của Google
- 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í khi sử dụng API Google Ads, nhưng có một hạn mức cho tổng số dự án trên đám mây.
Định cấu hình màn hình xin phép bằng OAuth
Nếu đang sử dụng một dự án hiện có trên Bảng điều khiển API của Google và đã định cấu hình màn hình xin phép bằng OAuth trước đó, thì bạn có thể bỏ qua bước này và sửa đổi màn hình đồng ý 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ị màn hình xin phép người dùng, trong đó có thông tin tóm tắt về dự án, các chính sách của dự án và phạm vi cấp quyền truy cập được 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 vào lúc khác.
Định cấu hình màn hình xin phép bằng OAuth mới
- 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.
- Chọn Kiểu người dùng rồi nhấp vào TẠO.
- Điền vào biểu mẫu màn hình đồng ý. Bạn có thể chỉnh sửa tên này sau, nếu cần. Nhấp vào LƯU VÀ TIẾP TỤC khi hoàn tất.
- Trên trang tiếp theo, hãy nhấp vào THÊM HOẶC XOÁ PHẠM VI.
- Di chuyển xuống và nhập nội dung sau vào trường trong phần Manual add scope (Thêm phạm vi theo cách thủ công):
https://www.googleapis.com/auth/adwords - Nhấp vào THÊM VÀO BẢNG.
- 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.
- Nhấp vào LƯU VÀ TIẾP TỤC.
- Nếu bạn không định xuất bản ngay dự án của mình, hãy thêm địa chỉ email của từng tài khoản người dùng mà bạn có thể dùng để thử nghiệm, sau đó nhấp vào LƯU VÀ TIẾP TỤC.
- Xem lại trang tóm tắt và nhấp vào QUAY LẠI TRANG TỔNG QUAN.
Định cấu hình màn hình xin phép bằng OAuth hiện có
- Mở trang Màn hình đồng ý, rồi chọn dự án của bạn trong trình đơn thả xuống ở đầu trang.
- Nhấp vào CHỈNH SỬA ỨNG DỤNG.
- 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.
- Trên trang tiếp theo, hãy nhấp vào THÊM HOẶC XOÁ PHẠM VI.
- Di chuyển xuống và nhập nội dung sau vào trường trong phần Manual add scope (Thêm phạm vi theo cách thủ công):
https://www.googleapis.com/auth/adwords - Nhấp vào THÊM VÀO BẢNG.
- Nhấp vào LƯU VÀ TIẾP TỤC.
- Nhấp vào LƯU VÀ TIẾP TỤC trên biểu mẫu Người dùng thử nghiệm.
- Xem lại trang tóm tắt và 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 Google API Console hiện đã có khoá bí mật và mã ứng dụng khách đượ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:
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.
Trên màn hình Thông tin xác thực, hãy nhấp vào TẠO XÁC THỰC, sau đó chọn 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 CONFIGURE CONSENT SCREEN (Màn hình đồng ý định cấu hình).
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 tên này sau, nếu cần. Nhấp vào Lưu khi hoàn tất.
Quay lại phần Thông tin đăng nhập > TẠO XÁC THỰC > Mã ứng dụng khách OAuth để tiếp tục.
Chọn loại ứng dụng là Desktop app (Ứng dụng dành cho máy tính) hoặc Web application (Ứng dụng web), tuỳ thuộc vào trường hợp sử dụng của bạn. Hướng dẫn này dùng loại ứng dụng là Desktop app (Ứng dụng dành cho máy tính).
Điền tên cho ứng dụng, sau đó nhấp vào Create (Tạo).
Trên trang xác nhận, hãy sao chép Mã ứng dụng khách và Mật khẩu ứng dụng 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 của bạn
Để bật API Google Ads trong dự án của bạn, hãy làm theo các bước sau:
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ả API hiện có, được nhóm theo nhóm sản phẩm và mức độ phổ biến.
Sử dụng tính năng tìm kiếm để tìm API Google Ads nếu API này không có trong danh sách.
Chọn API Google Ads, rồi nhấp vào nút Bật.