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

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 dùng để lấy thông tin xác thực 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 ngữ 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à ngoài mọi quy trình xem xét được thực hiện trong quy trình phê duyệt mã của nhà phát triển. Quy trình này là 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 tính phí và thường hoàn tất trong vòng từ 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 thực hiện quy trình xác minh OAuth của Google cho tất cả ứng dụng càng sớm càng tốt để tránh 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.

Điểm chính: Nếu đã bật tính năng thanh toán (ví dụ: 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í để sử dụng API Google Ads. Tuy nhiên, có hạn mức về tổng số dự án trên Google 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

Để bật API Google Ads cho dự á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 hoặc tạo 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 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, sau đó nhấp vào nút Bật.

Chọn loại người dùng và trạng thái phát hành

Sau khi bật API, bạn phải chỉ định Loại người dùng và Trạng thái phát hành của dự án. Bảng sau đây nêu bật một số thuộc tính chính và hạn chế của từng tổ hợp chế độ cài đặt này. Để biết thêm thông tin, 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 được liên kết với một Tổ chức trên Google Cloud. Giới hạn ở tối đa 100 người dùng thử nghiệm được liệt kê trong màn hình đồ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ền uỷ quyền sẽ hết hạn sau 7 ngày kể từ thời điểm đồng ý.
Bên ngoài	Thử nghiệm	Dành cho tất cả dự án. Giới hạn ở tối đa 100 người dùng thử nghiệm được liệt kê trong màn hình đồng ý OAuth. 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. Quyền uỷ quyền sẽ hết hạn sau 7 ngày kể từ thời điểm đồng ý.
Nội bộ	Phiên bản chính thức	Chỉ dành cho các dự án được liên kết với một Tổ chức trên Google Cloud. Cho phép uỷ quyền cho bất kỳ người dùng nào 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 tất cả dự án. Cho phép uỷ quyền cho bất kỳ người dùng nào 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 hoặc Trạng thái phát hành 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 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 vào biểu mẫu màn hình yêu cầu đồng ý. 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 trong mục 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 đị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ẽ sử dụng để kiểm thử, sau đó 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 PHÁT HÀNH ỨNG DỤNG để thay đổi Trạng thái phát hành từ Kiểm thử thành Đang phát hành công khai.

Chọn loại ứng dụng

Có hai 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 bằng một tài khoản người quản lý cấp cao nhất. Bạn là người dùng lần đầu hoặc muốn bắt đầu nhanh bằng cá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 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, 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 lệnh gọi lại. URL lệnh gọi lại không được hỗ trợ trong luồng ứ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 để bàn ngay cả khi đang phát triển một ứng dụng để chạy trên máy chủ. Sự khác biệt là việc uỷ quyền OAuth được hoàn tất cục bộ hay từ xa. Luồng trên máy tính yêu cầu phải hoàn tất quá trình uỷ quyền trên máy cục bộ, trong khi luồng trên web cho phép hoàn tất quá trình 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 Google Identity Platform dành 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 OAuth2 và khoá bí mật của ứng dụng khách:

1. Mở trang Thông tin xác thực. 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 CREATE CREDENTIALS (TẠO THÔNG TIN XÁC THỰC), sau đó chọn OAuth client ID (Mã ứng dụng khách OAuth).

   1. 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, thì bạn sẽ được hướng dẫn thực hiện việc này. Nhấp vào ĐỊNH CẤU HÌNH MÀN HÌNH XIN PHÉP.

      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 xác thực > TẠO THÔNG TIN XÁC THỰC > Mã ứng dụng khách 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 chiến dịch, sau đó 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 một cổng cụ thể. Nếu bạn không đặt cổng, ứng dụng OAuth có thể chuyển hướng đến bất kỳ cổng nào.

   Đối với ứng dụng ứng dụng dành cho máy tính, bạn vẫn sẽ sử dụng 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 và Khoá bí mật của ứng dụng khách vào bảng nhớ tạm vì bạn sẽ cần các thông tin này 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 chi tiết này.