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. Mã 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ặt hàng.

firstPublishTime

string (Timestamp format)

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

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 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 gian xuất bản gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 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 trả phí hay không.

homepageUri

string

Chỉ có đầu ra. 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). 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á trên 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á trên 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 hợp app_info.

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

chromeAppInfo

object (ChromeAppInfo)

Chỉ có đầu ra. Thông tin về ứng dụng 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 chỉ đị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 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 đang 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 các miền hoặc mẫu máy chủ lưu trữ rộng lớn. ( ví dụ: www.google.com). Trong đó có cả 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 dịch vụ hỗ trợ cho ứng dụng của họ. Trường dành riêng cho phiên bản này chỉ được thiết lập khi hệ thống tìm thấy phiên bản ứng dụng 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ó do 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 có chỉ dành cho chế độ Kiosk trên thiết bị ChromeOS hay không

isExtensionPolicySupported

boolean

Chỉ có đầu ra. Ứ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. Nếu có, một URI đến một trang có tài liệu về quyền hiện tại.

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 máy chủ.

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

string

Chỉ có đầu ra. Ví dụ: tệp này có thể chứa máy chủ hoặc các mẫu rất cụ thể như "*.com".

ItemType

Liệu một 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 chưa 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. 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à chi tiết lỗi.

Bạn có thể tìm hiểu thêm về mô hình lỗi này và cách xử lý lỗi 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

Một 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 phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc được ứng dụng bản địa hoá.

details[]

object

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

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

Phương thức

get

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