Bạn phải có 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. Các thông tin đăng nhập này sẽ xác định ứng dụng của bạn cho 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 đăng nhập Google OAuth2 được quản lý từ Google API Console.
Xem video này để biết một số phương pháp hay nhất đối với dự án Cloud
Xác minh OAuth của Google
Mọi ứng dụng Google Cloud được sử dụng để lấy thông tin đăng nhập cho phạm vi API Google Ads đều 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 trường hợp này, ứng dụng được định nghĩa là một mã ứng dụng khách OAuth 2.0 duy nhất trong Google Cloud.
Đây là quy trình xác minh độc lập, ngoài mọi quy trình 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 thường không mất phí. Quá 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 mọi 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
Để 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ả các API có sẵn, được nhóm theo nhóm sản phẩm và mức độ phổ biến.
Hãy 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.
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 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 chính và điểm hạn chế của từng 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 |
|
Không hoàn tất quy trình xác minh OAuth của Google sẽ dẫn đến kết quả sau, bất kể Loại người dùng hoặc 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àn hình giao diện người dùng chưa được xác minh.
Bạn chỉ được phép cấp phép 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 đồng ý rồi chọn dự án của bạn trong trình đơn thả xuống ở đầu trang.
Chọn Loại người dùng rồi nhấp vào TẠO.
Điền vào biểu mẫu 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.
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 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, sau đó 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 có kế hoạch 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.
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 phát hành của ứng dụng từ Kiểm thử thành Phát hành chính thức.
Chọn một loại ứng dụng
Có 2 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 loại phù hợp nhất với ứng dụng mà bạn muốn xây dựng:
Chọn loại ứng dụng này | Nếu ... |
---|---|
Ứng dụng cho máy tính |
|
Ứng dụng web |
|
Để 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 (Nền tảng Google Identity) dành cho ứng dụng 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 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 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 CREDENTIALS, sau đó chọn client ID (Mã ứng dụng khách OAuth).
Nếu trước đây chưa từng định cấu hình màn hình xin phép OAuth cho dự án này, thì bạn sẽ được chuyển hướng để thực hiện ngay bây giờ. Nhấp vào CẤU HÌNH 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 thông tin này sau nếu cần. Nhấp vào Lưu khi hoàn tất.
Hãy quay lại phần Credentials > CREATE CREDENTIALS > OAuth client ID (Thông tin xác thực > TẠO CREDENTIALS > Mã ứng dụng khách OAuth) để tiếp tục.
Chọn Desktop app (Ứng dụng cho máy tính) hoặc Web application (Ứ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.
Đặt tên cho kênh, rồi nhấp vào Tạo.
Nếu loại ứng dụng khách là Ứng dụng web, hãy thêm ít nhất một URI chuyển hướng được uỷ quyền.
Đối với 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 của chúng tôi, 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 lệnh chuyển hướng IP vòng lặp, nhưng URI chưa đượ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 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 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 vào lúc khác để truy xuất những thông tin chi tiết này.