Hướng dẫn này dành cho các nhà phát triển muốn sử dụng API AdMob để lấy dữ liệu trong tài khoản AdMob của họ theo phương thức lập trình.
Tất cả lệnh gọi API Google AdMob phải được uỷ quyền thông qua OAuth2 để ứng dụng của bạn có thể thay mặt người dùng tương tác với các dịch vụ web. OAuth2 cho phép ứng dụng khách API AdMob truy cập vào tài khoản AdMob của người dùng mà không cần phải 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
Quen thuộc 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 bên dưới để 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 Bảng điều khiển API của Google 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 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 có và muốn kích hoạt API AdMob cho dự án đó theo cách thủ công.
Tạo thông tin đăng nhập OAuth2
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.
Nhấp vào CREATE CREDENTIALS (TẠO THÔNG TIN XÁC THỰC) > OAuth client ID (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 chuyển hướng để thực hiện ngay bây giờ. Nhấp vào CÀI ĐẶT MÀN HÌNH ĐỒNG Ý. Có nhiều cách để định cấu hình màn hình đồng ý sử dụng mã ứng dụng khách OAuth 2.0.
- Đặt loại người dùng thành Bên ngoài và trạng thái phát hành thành Đã phát hành.
Hoặc đặt loại người dùng thành Bên ngoài và trạng thái phát hành 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 sử dụng mã ứng dụng OAuth 2.0.
Xem thêm thông tin về cách thiết lập màn hình xin phép bằ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, sau đó nhấp vào Tạo.
Khi hoàn tất, bạn sẽ thấy ID ứng dụng khách OAuth 2.0 và mật khẩu ứng dụng khách. Bạn có thể tải dữ liệu này xuống ở định dạng JSON và lưu để sử dụng sau này.
Tạo yêu cầu
API AdMob được xây dựng trên HTTP và JSON, vì vậy, mọi ứng dụng HTTP tiêu chuẩn đều có thể gửi yêu cầu đến API này và phân tích cú pháp các phản hồi. Tuy nhiên, Thư viện ứng dụng API của Google cung cấp tính năng tích hợp ngôn ngữ tốt hơn, cải thiện khả năng bảo mật và hỗ trợ đưa ra 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 có thể 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, chế độ cài đặt về khoảng không quảng cáo cũng như 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 của quảng cáo. Xem mã nhà xuất bản, múi giờ và mã đơn vị tiền tệ mặc định. |
Tạo yêu cầu đầu tiên để tạo báo cáo bằng các ví dụ trong Java, PHP, Python hoặc curl.
Thu hồi mã thông báo dùng chung
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 truy cập vào Tài khoản Google và 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 API nhận dạng của Google.