Bắt đầu sử dụng API AdMob

Hướng dẫn này dành cho những nhà phát triển muốn sử dụng API AdMob để tìm thông tin về 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 đều phải được uỷ quyền thông qua OAuth2 để ứng dụng 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 một 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 bài viết 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 cho máy tính
  • Bạn đang quản lý tất cả tài khoản API AdMob của mình bằng một tài khoản người quản lý cấp cao nhất.
  • Bạn là người mớ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 qua một máy.
Ứng dụng web
  • Bạn muốn xác thực với tư cách là một người dùng có thể cấp cho ứng dụng của bạn quyề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 đòi hỏi URL gọi lại. URL 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 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 này bằng công cụ thiết lập. Công cụ này sẽ hướng dẫn bạn thực hiện 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 sẽ áp dụng cho người dùng đang có một dự án 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 xác thực OAuth2

Các hướng dẫn sau 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 luồng ứng dụng đã cài đặt.

  1. Go to the Credentials page.

  2. Nhấp vào TẠO CÔNG CỤ XÁC NHẬ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 MÀN HÌNH ĐỒNG Ý CẤU HÌNH. Có nhiều cách để định cấu hình màn hình xin phép để 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 xuất bản thành Đã xuất bản.

    2. Bạn cũng có thể đặt loại người dùng thành Bên ngoài và trạng thái xuất bản thành Thử nghiệm, sau đó thêm Người dùng thử nghiệm 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 khách OAuth 2.0 của bạn.

      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 loại ứng dụng là Desktop app (Ứng dụng máy tính) hoặc Web Application (Ứng dụng web), đặt tên cho ứng dụng, sau đó nhấp vào Create (Tạo).

Khi hoàn tất, bạn sẽ thấy mã ứng dụng khách OAuth 2.0 và mật khẩu ứng dụng khách. Bạn có thể tải các mã này xuống ở định dạng JSON và lưu để sử dụng sau.

Tạo yêu cầu

API AdMob được xây dựng trên HTTP và JSON, do đó, mọi ứng dụng HTTP tiêu chuẩn đều có thể gửi yêu cầu tới API AdMob và phân tích cú pháp 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ợ việc đưa ra các yêu cầu được uỷ quyền. 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 này, 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.

Nếu 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 có 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 khoảng không quảng cáo và tính 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 hiệu suất quảng cáo và thu nhập. Xem mã nhà xuất bản, múi giờ và mã đơn vị tiền tệ mặc định.

Gửi 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 đã chia sẻ

Bạn có thể thu hồi mã thông báo đã chia sẻ theo 2 cách:

  1. Chuyển đến trang quyền của 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 cách sử dụng Google Identity API.