Cách bạn tạo và định cấu hình một dự án Google API Console phụ thuộc vào tình huống uỷ quyền OAuth 2.0 của ứng dụng. Chọn một trường hợp uỷ quyền để tuỳ chỉnh hướng dẫn này.
Bạn cần có một dự án trên Google API Console để tạo thông tin xác thực OAuth 2.0 và bật Google Ads API cho ứng dụng của mình.
Những thông tin đăng nhập này xác thực và cho phép ứng dụng hoặc người dùng Google Ads của bạn trên các máy chủ của Google, đồng thời 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 trên Bảng điều khiển API của Google
Để thiết lập một dự án mới, hãy làm theo hướng dẫn để tạo một dự án trên Google API Console. Bạn không bắt buộc phải bật tính năng thanh toán cho dự án. 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 Google Ads API, mặc dù các dự án trên Cloud phải tuân theo hạn mức dự án tiêu chuẩn.
Bật API Google Ads trong dự án của bạn
Để bật Google Ads API 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 bạn nhận được lời 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ả những API có sẵn, được nhóm theo nhóm sản phẩm và mức độ phổ biến.
Sử dụng chức năng tìm kiếm để tìm Google Ads API nếu API này không xuất hiện trong danh sách.
Chọn Google Ads API, rồi nhấp vào nút Bật.
Đăng ký quyền truy cập vào API
Tiếp theo, hãy truy cập vào trang Tổng quan về API Google Ads để kiểm tra cấp độ truy cập API hiện tại của bạn. Nếu cấp độ truy cập API hiện tại của bạn là Kiểm thử, hãy mở rộng mục Nâng cấp cấp độ truy cập. Làm theo hướng dẫn để đăng ký cấp truy cập Người khám phá.
Sau khi bạn hoàn tất đơn đăng ký, Google sẽ tự động xem xét và nâng cấp đơn đăng ký của bạn lên quyền truy cập của Nhà khám phá trong hầu hết các trường hợp.
Định cấu hình màn hình xin phép bằng OAuth
Khi bạn sử dụng OAuth 2.0 để uỷ quyền, Google sẽ hiển thị cho người dùng một màn hình xin phép, trong đó có nội dung tóm tắt về dự án, các chính sách và phạm vi uỷ 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 hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể xuất bản sau này.
Định cấu hình màn hình xin phép bằng OAuth cho ứng dụng của bạn và thêm https://www.googleapis.com/auth/adwords làm phạm vi OAuth.
Những điểm quan trọng cần cân nhắc đối với loại người dùng và trạng thái xuất bản
Khi định cấu hình màn hình xin phép bằng OAuth, hãy chú ý đến chế độ cài đặt Loại người dùng và Trạng thái xuất bản.
- Loại người dùng: Xác định xem ứng dụng của bạn chỉ dành cho người dùng trong tổ chức của bạn (Nội bộ) hay dành cho mọi người dùng Google (Bên ngoài). Nội bộ chỉ có sẵn nếu dự án của bạn là một phần của tổ chức Google Workspace.
- Trạng thái xuất bản: Xác định xem ứng dụng đang ở chế độ Kiểm thử (chỉ giới hạn cho những người dùng kiểm thử cụ thể mà bạn thêm) hay Đang phát hành công khai (dành cho đối tượng do Loại người dùng xác định, có thể yêu cầu Google xác minh ứng dụng).
Để đưa ra lựa chọn phù hợp nhất cho ứng dụng của bạn, hãy xem kỹ phần giải thích chi tiết và ý nghĩa của các chế độ cài đặt này trong tài liệu hỗ trợ chính thức của Google Cloud:
- Các lựa chọn về loại người dùng trên Màn hình xin phép bằng OAuth
- Các lựa chọn về trạng thái phát hành của Màn hình xin phép bằng OAuth
Việc hiểu rõ các chế độ cài đặt này là rất quan trọng để đảm bảo người dùng mục tiêu có thể truy cập vào ứng dụng của bạn.
Tạo mã ứng dụng khách và khoá bí mật của ứng dụng khách
Tạo mã ứng dụng khách và khoá bí mật của ứng dụng khách. Bạn có thể chọn Ứng dụng dành cho máy tính hoặc Ứng dụng web làm loại ứng dụng. Sau khi bạn tạo ứng dụng OAuth 2.0, hãy tải tệp JSON của ứng dụng xuống bằng cách nhấp vào nút Tải JSON xuống trên hộp thoại xác nhận.