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 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 Google OAuth2 được quản lý qua Google API Console.
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 xác thực cho phạm vi API Google Ads sẽ 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 đị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 là độc lập và bổ sung cho mọi hoạt động xem xét được thực hiện trong quy trình phê duyệt mã thông báo của nhà phát triển. Đây 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 sẽ hoàn toàn miễn phí. Quy trình này 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.
Tất cả các ứng dụng đều nên trải qua quy trình xác minh OAuth của Google càng sớm càng tốt để tránh tình trạng 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 Create project (Tạo dự án), nhập tên rồi nhấp vào Create (Tạo).
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:
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.
Chọn loại người dùng và trạng thái xuất bản
Sau khi bật API này, 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à điểm hạn chế của mỗi tổ hợp các 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 xuất bản | Các điểm hạn chế |
---|---|---|
Nội bộ | Kiểm thử |
|
External | Kiểm thử |
|
Nội bộ | Phiên bản chính thức |
|
External | Phiên bản chính thức |
|
Nếu bạn không hoàn tất quy trình xác minh OAuth của Google, các kết quả sau sẽ xảy ra, 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àn hình giao diện người dùng chưa được xác minh.
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
Mở trang Màn hình lấy sự đồ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, rồi nhập nội dung sau vào trường trong phần Manually add scopes (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 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.
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 sẽ dùng để kiểm thử, 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.
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 phát hành từ Kiểm thử thành Đang phát hành công khai.
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. Hãy tham khảo bảng sau đây để xác định kiểu 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 |
|
Ứng dụng web |
|
Để biết thêm thông tin, 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 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 bên dưới để tạo mã ứng dụng khách OAuth2 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 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 bây giờ. Nhấp vào CÀI ĐẶT MÀN HÌNH ĐỒNG Ý.
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.
Đặt tên cho tài khoản, rồi nhấp vào Tạo.
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 URI chuyển hướng được phép.
Để 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
.Đố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 tính năng 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.
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 vì bạn sẽ cần đến các mã này khi định cấu hình thư viện ứng dụng. 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.