- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Ứng dụng
- ManualAppInfo
- LinkedAppInfo
- AppApprovalState
- Ví dụ
- Hãy làm thử!
Liệt kê các ứng dụng trong tài khoản AdMob được chỉ định.
Yêu cầu HTTP
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
parent |
Bắt buộc. Tên tài nguyên của tài khoản để liệt kê ứng dụng. Ví dụ: accounts/pub-9876543210987654 |
Tham số truy vấn
Các tham số | |
---|---|
pageSize |
Số lượng ứng dụng tối đa cần trả về. Nếu bạn không chỉ định hoặc đặt giá trị là 0, thì hệ thống sẽ trả về tối đa 10.000 ứng dụng. Giá trị tối đa là 20.000; các giá trị trên 20.000 sẽ bị buộc thành 20.000. |
pageToken |
Giá trị được |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi cho yêu cầu về danh sách ứng dụng.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"apps": [
{
object ( |
Các trường | |
---|---|
apps[] |
Các ứng dụng thu được cho tài khoản được yêu cầu. |
nextPageToken |
Nếu giá trị không trống, hãy cho biết có thể có nhiều ứng dụng khác cho yêu cầu này; giá trị này phải được truyền vào một |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/admob.readonly
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
Ứng dụng
Mô tả một ứng dụng AdMob cho một nền tảng cụ thể (Ví dụ: Android hoặc iOS).
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "appId": string, "platform": string, "manualAppInfo": { object ( |
Các trường | |
---|---|
name |
Tên tài nguyên của ứng dụng này. Định dạng là accounts/{publisherId}/apps/{app_id_fragment} Ví dụ: accounts/pub-9876543210987654/apps/0123456789 |
appId |
Mã hiển thị bên ngoài của ứng dụng, có thể dùng để tích hợp với AdMob SDK. Đây là thuộc tính chỉ đọc. Ví dụ: ca-app-pub-9876543210987654~0123456789 |
platform |
Mô tả nền tảng của ứng dụng. Giới hạn cho "IOS" và "ANDROID". |
manualAppInfo |
Thông tin về một ứng dụng không được liên kết với bất kỳ cửa hàng ứng dụng nào. Sau khi ứng dụng được liên kết, thông tin này vẫn có thể truy xuất được. Nếu bạn không cung cấp tên cho ứng dụng khi tạo, thì tên phần giữ chỗ sẽ được sử dụng. |
linkedAppInfo |
Không thể thay đổi. Thông tin về ứng dụng được liên kết với cửa hàng ứng dụng. Trường này xuất hiện khi và chỉ khi ứng dụng được liên kết với một cửa hàng ứng dụng. |
appApprovalState |
Chỉ có đầu ra. Trạng thái phê duyệt của ứng dụng. Trường này ở chế độ chỉ có thể đọc. |
ManualAppInfo
Thông tin được cung cấp cho các ứng dụng nhập theo cách thủ công mà không liên kết với cửa hàng ứng dụng (Ví dụ: Google Play, App Store).
Biểu diễn dưới dạng JSON |
---|
{ "displayName": string } |
Các trường | |
---|---|
displayName |
Tên hiển thị của ứng dụng như hiển thị trong giao diện người dùng AdMob, do người dùng cung cấp. Độ dài tối đa cho phép là 80 ký tự. |
LinkedAppInfo
Thông tin từ cửa hàng ứng dụng nếu ứng dụng được liên kết với một cửa hàng ứng dụng.
Biểu diễn dưới dạng JSON |
---|
{ "appStoreId": string, "displayName": string } |
Các trường | |
---|---|
appStoreId |
Mã cửa hàng ứng dụng của ứng dụng; hiển thị khi và chỉ khi ứng dụng được liên kết với một cửa hàng ứng dụng. Nếu ứng dụng được thêm vào Cửa hàng Google Play, thì đó sẽ là mã ứng dụng của ứng dụng. Ví dụ: "com.example.myapp". Hãy xem https://developer.android.com/studio/build/application-id. Nếu ứng dụng được thêm vào Apple App Store, thì đó sẽ là mã cửa hàng ứng dụng. Ví dụ: "105169111". Xin lưu ý rằng việc đặt mã cửa hàng ứng dụng được xem là hành động không thể huỷ được. Bạn không thể huỷ liên kết sau khi liên kết một ứng dụng. |
displayName |
Chỉ có đầu ra. Hiển thị tên của ứng dụng khi ứng dụng xuất hiện trong cửa hàng ứng dụng. Đây là trường chỉ xuất và có thể trống nếu không tìm thấy ứng dụng trong cửa hàng. |
AppApprovalState
Các trạng thái phê duyệt ứng dụng dành cho ứng dụng di động.
Enum | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
Giá trị mặc định cho trường chưa được đặt. Không được dùng. |
ACTION_REQUIRED |
Ứng dụng yêu cầu người dùng thực hiện thêm thao tác để được phê duyệt. Vui lòng tham khảo https://support.google.com/admob/answer/10564477 để biết chi tiết và các bước tiếp theo. |
IN_REVIEW |
Ứng dụng đang chờ xem xét. |
APPROVED |
Ứng dụng được phê duyệt và có thể phân phát quảng cáo. |