REST Resource: customers.apps.android

Tài nguyên: AppDetails

Tài nguyên đại diện cho 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=customers/{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 riêng biệt của cửa hàng cho mặt hàng. Ví dụ: "gmbmikajjgmnabiglmofipeabaddhgne" cho phần mở rộng Lưu vào Google Drive của Chrome, "com.google.android.apps.docs" cho ứng dụng Google Drive trên Android.

revisionId

string

Chỉ có đầu ra. Phiên bản ứng dụng. Một bản sửa đổi mới sẽ được xác nhận mỗi khi một 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 một 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.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

latestPublishTime

string (Timestamp format)

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

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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 liệu ứng dụng có phải trả phí hay 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 là thông tin về phiên bản mới nhất của một ứng dụng.

reviewRating

number

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

serviceError

object (Status)

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

Trường nhóm 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 trên 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 trên 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,
  "manifestVersion": string
}
Trường
minUserCount

integer

Chỉ có đầu ra. Số lượng tối thiểu người dùng 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 cho phép truy cập vào các miền hoặc mẫu máy chủ lưu trữ rộng. ( ví dụ: www.google.com). Điề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ư các 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. Ứ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. Ứng dụng hoặc tiện ích đó có phải 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. Ứng dụng hoặc tiện ích có đang ở 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. Ứ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. Ứng dụng này 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 về các tiện ích hay không.

manifestVersion

string (int64 format)

Chỉ có đầu ra. Phiên bản của tệp kê khai tiện ích này.

ChromeAppPermission

Quyền do một ứ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ó, đây là một URI dẫn đến trang có tài liệu về quyền hiện tại.

accessUserData

boolean

Chỉ có đầu ra. Nếu có, liệu 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 truy cập vào máy chủ lưu trữ.

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

string

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

ItemType

Liệu một mục 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 được chỉ định.
EXTENSION Tiện ích của Chrome.
OTHERS Mọi loại khác ngoài phần mở rộng.

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à một ứng dụng Android yêu cầu.

AndroidAppPermission

Quyền do một ứ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ột 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 giao thức này. 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 và cách xử lý mô hình này 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à 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 mà người dùng nhìn thấy đều phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc được ứng dụng khách 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 các loại thông báo chung để API sử dụng.

Một đối tượng chứa các trường thuộc một loại tuỳ ý. Một trường bổ sung "@type" chứa một 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 đó.