Làm quen với API AdMob

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

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
  • Bạn đang quản lý tất cả tài khoản API AdMob 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 chỉ xác thực người dùng Google AdMob từ một máy.
Ứng dụng web
  • Bạn muốn xác thực dưới vai trò là một người dùng có thể cấp quyền cho ứng dụng của bạn truy cập vào dữ liệu tài khoản API AdMob 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ý các 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 quy trình ứng dụng dành cho máy tính.

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.

Để kích hoạt API cho dự án của bạn:

  1. Open the API Library trong Google API Console .
  2. If prompted, select a project, or create a new one. The API Library 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.
  3. Nếu API bạn muốn bật không hiển thị trong danh sách, hãy sử dụng tìm kiếm để tìm hoặc nhấp vào Xem tất cả trong họ sản phẩm mà nó thuộc về.
  4. Chọn API bạn muốn bật, sau đó nhấp vào nút Bật .
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

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.

  1. Go to the Credentials page.

  2. 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.

    1. Đặ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.

    2. 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.

  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, đặ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:

  1. 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.

  2. 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.