Đị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 cần có thông tin đăng nhập để truy cập vào các máy chủ OAuth2 của Google nhằm xác thực và uỷ quyền cho người dùng Google Ads. Thông tin xác thực 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ý người dùng Google Ads. Quyền truy cập vào thông tin xác thực Google OAuth2 được quản lý từ Google API Console.

Hãy xem video này để biết một số phương pháp hay nhất cho dự án trên đám mây

Xác minh OAuth của Google

Mọi ứng dụng Google Cloud được dùng để lấy thông tin đăng nhập cho phạm vi API Google Ads đều cần phải trải qua quy trình xác minh OAuth của Google để 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 bối cảnh này, ứng dụng được xác định là một Mã ứng dụng khách OAuth 2.0 duy nhất trong Google Cloud.

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

Quy trình xác minh của Google không mất phí và thường hoàn tất trong vòng 3 đến 5 ngày làm việc. Chính sách này áp dụng cho tất cả ứng dụng.

Bạn nên để tất cả ứng dụng trải qua quy trình xác minh Google OAuth càng sớm càng tốt để tránh mọi gián đoạn cho 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.

Điểm chính: Nếu đã bật tính năng thanh toán (ví dụ: cho Google Cloud), thì 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 Google Ads API, tuy nhiên, có hạn mức về tổng số dự án trên Cloud. Ngoài ra, bạn có thể đăng ký một Tài khoản Google mới có hạn mức dự án miễn phí.

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

Để bật Google Ads API 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 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.

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

3. Chọn Google Ads API, sau đó 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 và Trạng thái xuất bản của dự án. Bảng sau đây nêu bật một số thuộc tính và hạn chế chính của từng tổ hợp chế độ cài đặt này. Để biết thêm thông tin chi tiết, hãy tham khảo tài liệu về Google Cloud Platform.

Kiểu người dùng	Trạng thái phát hành	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 một Tổ chức trên Google Cloud. Chỉ dành cho tối đa 100 người dùng thử nghiệm có trong màn hình xin phép bằng OAuth. Người dùng thử nghiệm phải là người dùng nội bộ trong Tổ chức Google Cloud được liên kết với dự án. Quyết định cho phép 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 tất cả các dự án. Chỉ dành cho tối đa 100 người dùng thử nghiệm có trong màn hình xin phép bằng OAuth. Người dùng kiểm thử có thể là bất kỳ người dùng nào có Tài khoản Google. Quyết định cho phép 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 một Tổ chức trên Google Cloud. Cho phép uỷ quyền cho mọi người dùng trong Tổ chức Google Cloud được liên kết với dự án.
Bên ngoài	Phiên bản chính thức	Dành cho tất cả các dự án. Cho phép uỷ quyền cho mọi người dùng có Tài khoản Google.

Việc không hoàn tất quy trình xác minh Google OAuth sẽ dẫn đến những hậu quả sau, bất kể Loại người dùng hay Trạng thái xuất bản của dự án:

• Trong quá trình uỷ quyền, người dùng sẽ thấy một màn hình giao diện người dùng chưa xác minh.

• Bạn chỉ được phép uỷ quyền cho tối đa 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 xin phép rồi 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 thông tin vào biểu mẫu trên 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.

   • Di chuyển xuống rồi nhập nội dung sau vào trường bên dưới 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 mọi phạm vi khác mà dự án của bạn sẽ yêu cầu, sau đó 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 có ý định 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 sẽ dùng để kiểm thử, rồi nhấp vào LƯU VÀ TIẾP TỤC.

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

Sau khi kiểm thử ứng dụng và quy trình uỷ quyền, 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 Trạng thái xuất bản từ Kiểm thử thành Đang phát hành công khai.

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

Có 2 lựa chọn về loại ứng dụng cho API Google Ads: Máy tính hoặc Web. Hãy tham khảo bảng sau để xác định loại nào phù hợp nhất với ứng dụng mà 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 tài khoản người quản lý cấp cao duy nhất. Bạn là người dùng lần đầu hoặc muốn bắt đầu nhanh chóng với chế độ thiết lập đơn giản nhất. Ứng dụng của bạn sẽ chỉ xác thực người dùng Google trên một máy.
Ứng dụng web	Bạn muốn xác thực với tư cách 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 uỷ quyền, chẳng hạn như để 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 quy trình ứng dụng dành cho máy tính.

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

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

Tạo mã ứng dụng và khoá bí mật của ứng dụng

Sau khi xác định loại ứng dụng, hãy làm theo hướng dẫn bên dưới để tạo mã ứng dụng và khoá bí mật của ứng dụng OAuth2:

1. Mở trang Thông tin đăng nhập. Chọn một dự án đã tạo trước đó hoặc tạo một 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 THÔNG TIN XÁC THỰC, rồi chọn ID ứng dụng khách OAuth.

   1. Nếu trước đây chưa định cấu hình màn hình xin phép bằng OAuth cho dự án này, thì bạn sẽ được hướng dẫn thực hiện ngay. Nhấp vào CONFIGURE CONSENT SCREEN (Định cấu hình màn hình yêu cầu đồ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 thông tin này sau nếu cần. Nhấp vào Lưu khi hoàn tất.

   2. Quay lại mục Thông tin đăng nhập > TẠO THÔNG TIN ĐĂNG NHẬP > 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ỳ thuộc vào trường hợp sử dụng của bạn.

4. Đặt tên cho nhóm rồi nhấp vào Tạo.

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

   Để 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 cho một cổng cụ thể. Nếu bạn không đặt cổng, thì ứng dụng OAuth có thể chuyển hướng đến bất kỳ cổng nào.

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

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