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 cửa hàng duy nhất của 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 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 sẽ được thực hiện mỗi khi có phiên bản mới của ứng dụng.

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.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. 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 ở đị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 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. 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 thang điểm 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 hợp nhất app_info.

app_info chỉ có thể là một trong những giá trị 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
}
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 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ư 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à giao diện hay không.

googleOwned

boolean

Chỉ có đầu ra. Liệu ứ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ó ở trạng thái đã phát hành 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. Liệu ứng dụng có hỗ trợ chính sách cho tiện ích hay không.

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. URI đế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. 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 (nếu có).

ChromeAppSiteAccess

Biểu thị một quyền của 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. Ví dụ: chuỗi này có thể chứa các máy chủ lưu trữ hoặc mẫu rất cụ thể như "*.com".

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 không xác đị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. Quyền do ứ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ô 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 và cách xử lý mô hình lỗi 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 hiển thị với người dùng đều phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc do ứng dụng bản địa hoá.

details[]

object

Danh sách thông báo chứa thông tin chi tiết về lỗi. Có một bộ các 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ỳ ý. Một trường bổ sung "@type" 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 đó.