REST Resource: customers.apps.android

Tài nguyên: AppDetails

Tài nguyên biểu thị thông tin chi tiết về ứng dụng.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "appId": string,
  "revisionId": string,
  "type": enum (AppItemType),
  "iconUri": string,
  "detailUri": string,
  "firstPublishTime": string,
  "latestPublishTime": string,
  "publisher": string,
  "isPaidApp": boolean,
  "homepageUri": string,
  "privacyPolicyUri": string,
  "reviewNumber": string,
  "reviewRating": number,
  "serviceError": {
    object (Status)
  },

  // Union field app_info can be only one of the following:
  "chromeAppInfo": {
    object (ChromeAppInfo)
  },
  "androidAppInfo": {
    object (AndroidAppInfo)
  }
  // End of list of possible types for union field app_info.
}
Trường
name

string

Chỉ có đầu ra. Định dạng: name=customer/{customer_id}/apps/{chrome|android|web}/{appId}@{version}

displayName

string

Chỉ có đầu ra. Tên hiển thị của ứng dụng.

description

string

Chỉ có đầu ra. Nội dung mô tả ứng dụng.

appId

string

Chỉ có đầu ra. Giá trị nhận dạng cửa hàng duy nhất của mặt hàng. Ví dụ: "gmbmikajjgmnabiglmofipeabaddhgne" cho tiện ích Lưu vào Google Drive của Chrome, "com.google.android.apps.docs" cho ứng dụng Google Drive dành cho Android.

revisionId

string

Chỉ có đầu ra. Phiên bản ứng dụng. Một bản sửa đổi mới được cam kết bất cứ khi nào phiên bản mới của ứng dụng được xuất bản.

type

enum (AppItemType)

Chỉ có đầu ra. Loại ứng dụng.

iconUri

string

Chỉ có đầu ra. Đường liên kết đến hình ảnh có thể dùng làm biểu tượng cho sản phẩm.

detailUri

string

Chỉ có đầu ra. URI cho trang chi tiết của mục.

firstPublishTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian xuất bản lần đầu.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

latestPublishTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm xuất bản gần đây nhất.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

publisher

string

Chỉ có đầu ra. Nhà xuất bản của mặt hàng.

isPaidApp

boolean

Chỉ có đầu ra. Cho biết ứng dụng có phải được trả tiền cho HOẶC có nội dung có tính phí hay không.

homepageUri

string

Chỉ có đầu ra. URI trang chủ hoặc URI trang web.

privacyPolicyUri

string

Chỉ có đầu ra. URI trỏ đến chính sách quyền riêng tư của ứng dụng (nếu nhà phát triển cung cấp chính sách này). Trường dành riêng cho phiên bản sẽ chỉ được đặt khi tìm thấy phiên bản ứng dụng được yêu cầu.

reviewNumber

string (int64 format)

Chỉ có đầu ra. Số lượng bài đánh giá đã nhận được. Thông tin đánh giá của Cửa hàng Chrome trực tuyến sẽ luôn dành cho phiên bản mới nhất của ứng dụng.

reviewRating

number

Chỉ có đầu ra. Điểm xếp hạng của ứng dụng (trên 5 sao). Thông tin đánh giá của Cửa hàng Chrome trực tuyến sẽ luôn dành cho phiên bản mới nhất của ứng dụng.

serviceError

object (Status)

Chỉ có đầu ra. Thông tin về lỗi dịch vụ một phần, nếu có.

Trường kết hợp app_info.

app_info chỉ có thể là một trong những trạng thái sau đây:

chromeAppInfo

object (ChromeAppInfo)

Chỉ có đầu ra. Thông tin về ứng dụng trong Cửa hàng Chrome trực tuyến.

androidAppInfo

object (AndroidAppInfo)

Chỉ có đầu ra. Thông tin về ứng dụng Android.

AppItemType

Loại ứng dụng.

Enum
APP_ITEM_TYPE_UNSPECIFIED Chưa xác định loại ứng dụng.
CHROME Ứng dụng Chrome.
ANDROID ứng dụng ARC++.
WEB Ứng dụng web.

ChromeAppInfo

Thông tin về ứng dụng trong Cửa hàng Chrome trực tuyến.

Biểu diễn dưới dạng JSON
{
  "minUserCount": integer,
  "permissions": [
    {
      object (ChromeAppPermission)
    }
  ],
  "siteAccess": [
    {
      object (ChromeAppSiteAccess)
    }
  ],
  "type": enum (ItemType),
  "supportEnabled": boolean,
  "isTheme": boolean,
  "googleOwned": boolean,
  "isCwsHosted": boolean,
  "kioskEnabled": boolean,
  "isKioskOnly": boolean,
  "isExtensionPolicySupported": boolean
}
Trường
minUserCount

integer

Chỉ có đầu ra. Số người dùng tối thiểu sử dụng ứng dụng này.

permissions[]

object (ChromeAppPermission)

Chỉ có đầu ra. Mọi quyền tuỳ chỉnh mà ứng dụng yêu cầu. Trường dành riêng cho phiên bản sẽ chỉ được đặt khi tìm thấy phiên bản ứng dụng được yêu cầu.

siteAccess[]

object (ChromeAppSiteAccess)

Chỉ có đầu ra. Mọi quyền cấp quyền truy cập vào miền hoặc các mẫu máy chủ lưu trữ trên phạm vi rộng. ( ví dụ: www.google.com). Dữ liệu này bao gồm các kết quả trùng khớp từ tập lệnh nội dung cũng như máy chủ lưu trữ trong nút quyền của tệp kê khai. Trường dành riêng cho phiên bản sẽ chỉ được đặt khi tìm thấy phiên bản ứng dụng được yêu cầu.

type

enum (ItemType)

Chỉ có đầu ra. Các loại mặt hàng trong Cửa hàng Chrome trực tuyến

supportEnabled

boolean

Chỉ có đầu ra. Nhà phát triển ứng dụng đã bật tính năng hỗ trợ cho ứng dụng của họ. Trường dành riêng cho phiên bản sẽ chỉ được đặt khi tìm thấy phiên bản ứng dụng được yêu cầu.

isTheme

boolean

Chỉ có đầu ra. Liệu ứng dụng hoặc tiện ích có phải là một giao diện hay không.

googleOwned

boolean

Chỉ có đầu ra. Liệu ứng dụng hoặc tiện ích có được Google tạo và duy trì hay không. Trường dành riêng cho phiên bản sẽ chỉ được đặt khi tìm thấy phiên bản ứng dụng được yêu cầu.

isCwsHosted

boolean

Chỉ có đầu ra. Liệu ứng dụng hoặc tiện ích có ở trạng thái đã xuất bản trong Cửa hàng Chrome trực tuyến hay không.

kioskEnabled

boolean

Chỉ có đầu ra. Liệu ứng dụng này có được bật cho Chế độ kiosk trên thiết bị ChromeOS hay không

isKioskOnly

boolean

Chỉ có đầu ra. Liệu ứng dụng chỉ dành cho chế độ Kiosk trên thiết bị ChromeOS hay không

isExtensionPolicySupported

boolean

Chỉ có đầu ra. Liệu ứng dụng có hỗ trợ chính sách cho tiện ích hay không.

ChromeAppPermission

Quyền mà ứng dụng hoặc tiện ích của Chrome yêu cầu.

Biểu diễn dưới dạng JSON
{
  "type": string,
  "documentationUri": string,
  "accessUserData": boolean
}
Trường
type

string

Chỉ có đầu ra. Loại quyền.

documentationUri

string

Chỉ có đầu ra. URL dẫn đến một trang có tài liệu về quyền hiện tại (nếu có).

accessUserData

boolean

Chỉ có đầu ra. Nếu có, quyền này có cấp cho ứng dụng/tiện ích quyền truy cập vào dữ liệu người dùng hay không.

ChromeAppSiteAccess

Đại diện cho một quyền của máy chủ.

Biểu diễn dưới dạng JSON
{
  "hostMatch": string
}
Trường
hostMatch

string

Chỉ có đầu ra. Tên này có thể chứa các máy chủ lưu trữ hoặc mẫu rất cụ thể như "*.com" chẳng hạn.

ItemType

Liệu mặt hàng trong Cửa hàng Chrome trực tuyến có phải là tiện ích hay không.

Enum
ITEM_TYPE_UNSPECIFIED ItemType không xác định.
EXTENSION Tiện ích của Chrome.
OTHERS Bất kỳ loại nào khác ngoài tiện ích.

AndroidAppInfo

Thông tin về ứng dụng Android.

Biểu diễn dưới dạng JSON
{
  "permissions": [
    {
      object (AndroidAppPermission)
    }
  ]
}
Trường
permissions[]

object (AndroidAppPermission)

Chỉ có đầu ra. Các quyền mà ứng dụng Android yêu cầu.

AndroidAppPermission

Quyền do ứng dụng Android yêu cầu.

Biểu diễn dưới dạng JSON
{
  "type": string
}
Trường
type

string

Chỉ có đầu ra. Loại quyền.

Trạng thái

Loại Status xác định mô hình lỗi logic phù hợp với nhiều môi trường lập trình, bao gồm cả API REST và API RPC. Hàm này được gRPC sử dụng. Mỗi thông báo Status chứa 3 phần dữ liệu: mã lỗi, thông báo lỗi và thông tin chi tiết về lỗi.

Bạn có thể tìm hiểu thêm về mô hình lỗi này cũng như cách xử lý trong Hướng dẫn thiết kế API.

Biểu diễn dưới dạng JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Trường
code

integer

Mã trạng thái, phải là một giá trị enum của google.rpc.Code.

message

string

Thông báo lỗi dành cho nhà phát triển, phải bằng tiếng Anh. Mọi thông báo lỗi dành cho người dùng đều phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc để ứng dụng bản địa hoá.

details[]

object

Danh sách các thông báo chứa thông tin chi tiết về lỗi. Có một nhóm loại thông báo phổ biến để API sử dụng.

Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung "@type" chứa URI xác định kiểu. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.

Phương thức

get

Tìm một ứng dụng cụ thể cho khách hàng theo tên tài nguyên của ứng dụng đó.