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 API AdMob 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 đăng nhập OAuth2 và đưa ra yêu cầu đầu tiên.
Điều kiện tiên quyết
Làm quen với các 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 dự án
Để bắt đầu sử dụng AdMob API, 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 quy trình và tự động kích hoạt AdMob API.
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 một API cho dự án:
- Mở Thư viện API trong Google API Console.
- Nếu bạn nhận được lời nhắc, hãy chọn một dự án hoặc tạo dự án mới. Thư viện API 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.
- Nếu bạn nhận được một lời nhắc, hãy bật tính năng thanh toán.
- Nếu bạn nhận được một lời nhắc, vui lòng đọc và chấp nhận Điều khoản dịch vụ của API.
Tạo thông tin đăng nhập OAuth2
Hướng dẫn sau đây sẽ giúp bạn biết cách tạo mã ứng dụng khách OAuth 2.0 để sử dụng với quy trình ứng dụng cần cài đặt.
Chuyển đến trang Ứng dụng.
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ây giờ bạn sẽ được chuyển hướng để làm việc đó. Nhấp vào ĐỊNH CẤU HÌNH MÀN HÌNH YÊU CẦU ĐỒNG Ý. 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.
- Đặ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 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.
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ẽ nhận được mã ứng dụng OAuth 2.0 và khoá bí mật của ứng dụng. Bạn có thể tải mã ứng dụng 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
AdMob API được xây dựng trên HTTP và JSON, nên mọi ứng dụng HTTP tiêu chuẩn đều có thể gửi yêu cầu tới API này và phân tích cú pháp các phản hồi. Tuy nhiên, các 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ó 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ó sẵn bằng nhiều 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 phải thiết lập yêu cầu HTTP và phân tích cú pháp các 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 truy cập:
| 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à hoạt độ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ề 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. |
Đưa ra 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.