Định cấu hình dự án trên Bảng điều khiển API của Google cho API Google Ads

Bạn phải cung cấp thông tin đăng nhập để truy cập vào máy chủ OAuth2 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 xác định ứng dụng của bạn với Google, cho phép bạn tạo mã thông báo OAuth để quản lý Google Ads người dùng. Quyền truy cập vào thông tin xác thực Google OAuth2 được quản lý trên Bảng điều khiển API của Google.

Xem video này để biết một số phương pháp hay nhất cho dự án Cloud

Xác minh OAuth của Google

Mọi ứng dụng Google Cloud dùng để lấy thông tin đăng nhập cho phạm vi API Google Ads sẽ cần trải qua một Google OAuth xác minh để tránh màn hình giao diện người dùng chưa được xác minh cho người dùng. Trong trường hợp này, ứng dụng được định nghĩa là mã ứng dụng khách OAuth 2.0 duy nhất trong Google Cloud.

Quá trình xác minh này mang tính độc lập và bổ sung cho mọi hoạt động đánh giá được thực hiện dưới dạng thuộc quy trình phê duyệt mã thông báo của nhà phát triển, và là bắt buộc vì phạm vi API Google Ads là thông tin nhạy cảm phạm vi.

Quy trình xác minh qua Google sẽ hoàn toàn miễn phí. Quy trình này thường hoàn tất trong vòng từ 3 đến 3 phút 5 ngày làm việc. Chính sách này áp dụng cho tất cả ứng dụng.

Tất cả các ứng dụng nên trải qua quy trình xác minh OAuth của Google càng sớm càng tốt nhất có thể để tránh bị gián đoạn hoạt động kinh doanh.

Tạo một dự án

Chuyển đến Google API Console. Nhấp vào Tạo dự án. nhập tên rồi nhấp vào Tạo.

Lưu ý quan trọng: Nếu bạn đã bật tính năng thanh toán, thì đối với Google Cloud đối với dự án mới – bạn phải 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 về tổng chi phí số lượng dự án Cloud. Ngoài ra, bạn có thể đăng ký một tài khoản Google Tài khoản bao gồm một hạn mức dự án miễn phí.

Bật API Google Ads trong dự án của bạn

Để bật API Google Ads cho dự án của bạ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 hoặc tạo một dự án mới. Thư viện API liệt kê tất cả thư viện có sẵn API, được nhóm theo nhóm sản phẩm và mức độ phổ biến.

2. 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.

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

Chọn loại người dùng và trạng thái xuất bản

Sau khi bật API, bạn phải chỉ định Loại người dùng cho dự án và Trạng thái xuất bản. Bảng sau đây nêu bật một số thuộc tính chính và giới hạn của từng tổ hợp các cài đặt này. Để biết thêm thông tin, hãy tham khảo Google Cloud Platform .

Kiểu người dùng	Trạng thái xuất bản	Các điểm hạn chế
Nội bộ	Thử nghiệm	Chỉ dành cho các dự án liên kết với Google Cloud Sắp xếp. Tối đa 100 người dùng thử nghiệm được liệt kê trong phần đồng ý OAuth màn hình. Người dùng thử nghiệm phải là người dùng nội bộ trong Google Cloud Tổ chức được liên kết với dự án. Uỷ quyền sẽ hết hạn sau 7 ngày kể từ thời điểm bạn đồng ý.
Bên ngoài	Thử nghiệm	Dành cho mọi dự án. Tối đa 100 người dùng thử nghiệm được liệt kê trong phần đồng ý OAuth màn hình. Người dùng thử nghiệm có thể là bất kỳ người dùng nào có Tài khoản Google. Uỷ quyền sẽ hết hạn sau 7 ngày kể từ thời điểm bạn đồng ý.
Nội bộ	Phiên bản chính thức	Chỉ dành cho các dự án liên kết với Google Cloud Sắp xếp. Cho phép uỷ quyền cho mọi người dùng trong Tổ chức Google Cloud liên kết với dự án.
Bên ngoài	Phiên bản chính thức	Dành cho mọi dự án. Cho phép uỷ quyền cho bất kỳ người dùng nào có Tài khoản Google.

Chưa hoàn tất Google OAuth xác minh dẫn đến những kết quả sau, bất kể Kiểu người dùng hay Xuất bản trạng thái của dự án:

• Trong quá trình cấp phép, người dùng sẽ thấy một giao diện người dùng chưa được xác minh màn hình.

• Bạn chỉ được cấp quyền cho 100 người dùng.

Định cấu hình màn hình xin phép bằng OAuth

1. Mở trang Màn hình đồng ý, rồi chọn dự án trong trình đơn thả xuống ở đầu trang.

2. Chọn Kiểu 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 đồng ý. Bạn có thể chỉnh sửa tên này sau, nếu cần. Nhấp chuột 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.

   • Cuộn xuống và nhập nội dung sau vào trường trong Thêm theo cách thủ công phạm vi:

     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 sẽ yêu cầu, rồi nhấp vào CẬP NHẬT.

   • Nhấp vào LƯU VÀ TIẾP TỤC.

5. Nếu bạn không định xuất bản dự án ngay lập tức, hãy thêm địa chỉ email này của từng tài khoản người dùng mà bạn sẽ dùng để thử nghiệm, sau đó nhấp vào LƯU VÀ TIẾP TỤC.

6. Xem lại trang tóm tắt và nhấp vào QUAY LẠI TRANG TỔNG QUAN.

Khi đã kiểm tra ứng dụng và quy trình cấp phép, bạn có thể quay lại trang tổng quan rồi nhấp vào XUẤT BẢN ỨNG DỤNG để thay đổi việc Xuất bản ứng dụng từ Thử nghiệm đến Trong phiên bản chính thức.

Chọn một loại ứng dụng

Có hai loại ứng dụng cho API Google Ads: Máy tính hoặc Web. Tham khảo bảng sau đây để xác định loại phù hợp nhất với ứng dụng bạn muốn để tạo:

Chọn loại ứng dụng này	Nếu ...
Ứng dụng dành cho máy tính	Bạn đang quản lý tất cả tài khoản Google Ads của mình bằng một cấp cao nhất tài khoản người quản lý. Bạn là người mới dùng hoặc muốn làm quen nhanh với những thao tác đơn giản nhất thiết lập. Ứng dụng của bạn sẽ chỉ xác thực người dùng Google từ một máy.
Ứng dụng web	Bạn muốn xác thực là người dùng có thể cấp quyền cho ứng dụng của bạn để truy cập vào dữ liệu tài khoản Google Ads của họ. Bạn muốn dễ dàng tạo nhiều thông tin xác thực uỷ quyền để quản lý tài khoản bên thứ ba. Ứng dụng của bạn yêu cầu URL gọi lại. URL gọi lại không được hỗ trợ trong luồng ứng dụng dành cho máy tính để bàn.

Lưu ý quan trọng: Bạn vẫn có thể chọn quy trình cho ứng dụng dành cho máy tính để bàn ngay cả khi bạn đang phát triển một ứng dụng chạy trên máy chủ. Điểm khác biệt là việc uỷ quyền OAuth hoàn tất cục bộ hoặc từ xa. Một quy trình trên máy tính để bàn yêu cầu ủy quyền hoàn tất trên máy cục bộ, trong khi luồng web cho phép việc uỷ quyền hoàn tất trên máy chủ uỷ quyền của Google.

Để biết thêm thông tin, hãy tham khảo tài liệu về OAuth của Google Identity Platform ứng dụng dành cho máy tính hoặc ứng dụng web.

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

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 dưới đây để tạo mã ứng dụng khách OAuth2 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 XÁC NHẬN QUYỀN SỞ HỮU, sau đó chọn OAuth client ID.

   1. Nếu bạn chưa định cấu hình màn hình xin phép bằng OAuth cho dự án này trước đây, bạn sẽ được hướng dẫn để thực hiện việc này ngay bây giờ. Nhấp chuột CẤU HÌNH MÀN HÌNH ĐỒNG Ý.

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

      2. Đ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 chuột Lưu khi hoàn tất.

   2. Quay lại phần Thông tin xác thực > TẠO NỘI DUNG uy tín > Mã ứng dụng OAuth để tiếp tục.

3. 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, tuỳ theo trường hợp sử dụng của bạn.

4. Đặt tên cho tài khoản, rồi nhấp vào Tạo.

5. Nếu loại ứng dụng của bạn là Ứng dụng web, hãy thêm ít nhất một ứng dụng được cấp phép URI chuyển hướng.

   Để kiểm thử cục bộ tương thích với cấu hình mặc định trong các ví dụ về thư viện ứng dụng, hãy sử dụng http://127.0.0.1.

   Lưu ý: Bạn có thể thêm số cổng vào URI chuyển hướng để hạn chế việc sử dụng một cổng cụ thể. Nếu bạn không thiết lập cổng này, ứng dụng OAuth có thể chuyển hướng đến bất kỳ cổng.

   Đối với các ứng dụng Ứng dụng dành cho máy tính, bạn vẫn sẽ sử dụng lệnh chuyển hướng IP lặp lại, nhưng URI không được định cấu hình rõ ràng trong bảng điều khiển Cloud.

6. Trên trang xác nhận, sao chép Mã ứng dụng khách của bạn và Mật khẩu ứng dụng khách của bạn vào bảng nhớ tạm, vì bạn sẽ cần đến chúng khi định cấu hình ứng dụng thư viện của bạn. Bạn cũng có thể quay lại trang thông tin đăng nhập sau để truy xuất chi tiết.