Tất cả các lệnh gọi API Google AdMob đều phải được uỷ quyền thông qua OAuth2 để ứng dụng của bạn có thể tương tác với các dịch vụ web thay cho người dùng. OAuth2 cho phép ứng dụng AdMob API của bạn truy cập vào tài khoản AdMob của người dùng mà không cần xử lý hoặc lưu trữ tên người dùng hoặc mật khẩu của người dùng. Để biết thông tin tổng quan về việc uỷ quyền, hãy xem phần Uỷ quyền.
Thực hiện các bước sau để tạo thông tin xác thực OAuth2 và đưa ra yêu cầu đầu tiên.
Điều kiện tiên quyết
Làm quen với kiến thức cơ bản về REST và uỷ quyền cho các yêu cầu bằng OAuth 2.0.
Xác định loại xác thực
Hãy xem bảng dưới đây để biết loại xác thực nào phù hợp nhất với ứng dụng của bạn:
| Chọn loại xác thực OAuth2 | Nếu ... |
|---|---|
| Ứng dụng dành cho máy tính |
|
| Ứng dụng web |
|
Tạo một dự án
Để bắt đầu sử dụng API AdMob, trước tiên bạn cần tạo hoặc chọn một dự án trong Google API Console và bật API bằng công cụ thiết lập. Công cụ này sẽ hướng dẫn bạn trong quy trình và tự động kích hoạt API AdMob.
Bật API cho một dự án hiện có
Các bước sau đây áp dụng cho những người dùng có dự án hiện tại và muốn kích hoạt AdMob API cho dự án đó theo cách thủ công.
Cách bật API cho dự án:
- Open the API Library trong Google API Console.
- If prompted, select a project, or create a new one. Thư viện API API Library 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.
- Nếu API bạn muốn bật không xuất hiện trong danh sách, hãy sử dụng chức năng tìm kiếm để tìm API đó hoặc nhấp vào Xem tất cả trong nhóm sản phẩm mà API đó thuộc về.
- Chọn API bạn muốn bật, sau đó nhấp vào nút Bật.
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
Tạo thông tin đăng nhập OAuth2
Các hướng dẫn sau đây sẽ hướng dẫn bạn quy trình tạo mã ứng dụng khách OAuth 2.0 để sử dụng với quy trình ứng dụng đã cài đặt.
- Go to the Clients page.
Nhấp vào TẠO THÔNG TIN XÁC THỰC > Mã ứng dụng 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. Nhấp vào ĐỊNH CẤU HÌNH MÀN HÌNH YÊU CẦU SỰ ĐỒNG Ý. Có nhiều cách để định cấu hình màn hình đồng ý nhằm sử dụng mã ứng dụng OAuth 2.0.
- Đặt loại người dùng thành Bên ngoài và trạng thái xuất bản thành Đã xuất bản.
Hoặc đặt loại người dùng thành Bên ngoài và trạng thái xuất bản thành Kiểm thử, sau đó thêm Người dùng kiểm thử bằng cách chọn thêm người dùng để cấp cho họ quyền truy cập sử dụng mã ứng dụng OAuth 2.0 của bạn.
Xem thêm thông tin về cách thiết lập màn hình đồng ý OAuth.
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, đặt tên cho ứng dụng đó, rồi nhấp vào Tạo.
Sau khi hoàn tất, bạn sẽ thấy mã ứng dụng khách và khoá bí mật của ứng dụng khách OAuth 2.0. Bạn có thể tải mã ứng dụng khách và khoá bí mật này xuống ở định dạng JSON rồi lưu lại để sử dụng sau.
Tạo yêu cầu
API AdMob được xây dựng trên HTTP và JSON, nhờ đó, mọi ứng dụng HTTP chuẩn đều có thể gửi yêu cầu tới API AdMob và phân tích cú pháp các phản hồi. Tuy nhiên, thư viện ứng dụng Google API cung cấp tính năng tích hợp ngôn ngữ tốt hơn, có mức độ bảo mật cao hơn và hỗ trợ thực hiện các yêu cầu được uỷ quyền. Các thư viện ứng dụng được cung cấp bằng một số ngôn ngữ lập trình. Bằng cách sử dụng các thư viện đó, bạn có thể tránh được việc phải thiết lập yêu cầu HTTP và phân tích cú pháp phản hồi theo cách thủ công.
Sau khi tạo thông tin xác thực OAuth 2.0, bạn đã sẵn sàng bắt đầu sử dụng API AdMob. Để yêu cầu quyền truy cập bằng OAuth 2.0, ứng dụng của bạn cũng cần thông tin về phạm vi:
| Phạm vi | Ý nghĩa |
|---|---|
https://www.googleapis.com/auth/admob.readonly |
Xem tất cả dữ liệu AdMob. Dữ liệu này có thể bao gồm thông tin tài khoản, các chế độ cài đặt về khoảng không quảng cáo và chức năng dàn xếp, báo cáo và các dữ liệu khác. Tuy nhiên, nữ liệu này không bao gồm dữ liệu nhạy cảm (chẳng hạn như thông tin về thanh toán hoặc thông tin chiến dịch). |
https://www.googleapis.com/auth/admob.report |
Xem báo cáo về thu nhập và hiệu suất quảng cáo. Xem mã nhà xuất bản, múi giờ và mã đơn vị tiền tệ mặc định. |
Thực hiện yêu cầu đầu tiên để tạo báo cáo bằng cách sử dụng các ví dụ trong Java, PHP, Python hoặc curl.
Thu hồi mã thông báo được chia sẻ
Bạn có thể thu hồi mã thông báo được chia sẻ theo hai cách:
Chuyển đến trang quyền của Tài khoản Google rồi thu hồi quyền truy cập của dự án có liên quan.
Ngoài ra, bạn có thể thu hồi mã thông báo ứng dụng web bằng Google Identity API.