Method: accounts.apps.list

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

Tham số
parent

string

Bắt buộc. Tên tài nguyên của tài khoản để liệt kê các ứng dụng. Ví dụ: accounts/pub-9876543210987654

Tham số truy vấn

Thông số
pageSize

integer

Số lượng ứng dụng tối đa cần trả về. Nếu bạn không chỉ định hoặc chỉ định giá trị 0, thì tối đa 10.000 ứng dụng sẽ được trả về. Giá trị tối đa là 20.000; các giá trị trên 20.000 sẽ được chuyển đổi thành 20.000.
pageToken

string

Giá trị được trả về bởi ListAppsResponse gần nhất; giá trị này cho biết đây là phần tiếp theo của lệnh gọi apps.list trước đó và hệ thống sẽ trả về trang dữ liệu tiếp theo.

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 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 (App)
    }
  ],
  "nextPageToken": string
}
Trường
apps[]

object (App)

Các ứng dụng thu được cho tài khoản được yêu cầu.
nextPageToken

string

Nếu giá trị này không trống, thì điều đó có nghĩa là có thể có nhiều ứng dụng hơn cho yêu cầu này; bạn phải chuyển giá trị này vào trong một ListAppsRequest mới.

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 OAuth 2.0 Overview.

Ứ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 (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
Trường
name

string

Tên tài nguyên cho ứng dụng này. Định dạng là accounts/{publisherId}/apps/{app_id_fragment} Ví dụ: accounts/pub-9876543210987654/apps/0123456789
appId

string

Mã nhận dạng có thể nhìn thấy bên ngoài của ứng dụng. Bạn có thể dùng mã này để tích hợp với AdMob SDK. Đây là một thuộc tính chỉ đọc. Ví dụ: ca-app-pub-9876543210987654~0123456789
platform

string

Mô tả nền tảng của ứng dụng. Chỉ có thể là "IOS" và "ANDROID".
manualAppInfo

object (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, bạn vẫn có thể truy xuất thông tin này. Nếu bạn không cung cấp tên cho ứng dụng khi tạo, thì tên giữ chỗ sẽ được dùng.
linkedAppInfo

object (LinkedAppInfo)

Không thể thay đổi. Thông tin về một ứng dụng được liên kết với một cửa hàng ứng dụng.

Trường này chỉ xuất hiện nếu ứng dụng được liên kết với một cửa hàng ứng dụng.
appApprovalState

enum (AppApprovalState)

Chỉ có đầu ra. Trạng thái phê duyệt của ứng dụng. Trường này ở chế độ chỉ đọc.

ManualAppInfo

Thông tin được cung cấp cho các ứng dụng thủ công 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
}
Trường
displayName

string

Tên hiển thị của ứng dụng như xuất hiện trong giao diện người dùng AdMob, do người dùng cung cấp. Độ dài tối đa được 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
}
Trường
appStoreId

string

Mã cửa hàng ứng dụng của ứng dụng; xuất hiện nếu 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 coi là một hành động không thể đảo ngược. Sau khi liên kết, bạn không thể huỷ liên kết ứng dụng.
displayName

string

Chỉ có đầu ra. Tên hiển thị của ứng dụng như xuất hiện trong cửa hàng ứng dụng. Đây là trường chỉ có đầu ra và có thể trống nếu không tìm thấy ứng dụng trong cửa hàng.

AppApprovalState

Trạng thái phê duyệt ứng dụng của một ứng dụng di động.

Enum
APP_APPROVAL_STATE_UNSPECIFIED Giá trị mặc định cho một trường chưa được đặt. Không được dùng.
ACTION_REQUIRED Ứng dụng này 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 bài viết https://support.google.com/admob/answer/10564477 để biết thông tin 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 này đã được phê duyệt và có thể phân phát quảng cáo.