REST Resource: customers.apps.android

Tài nguyên: AppDetails

Tài nguyên đại diện cho chi tiết ứ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)
  },
  "categoryIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "chromeAppInfo": {
    object (ChromeAppInfo)
  },
  "androidAppInfo": {
    object (AndroidAppInfo)
  }
  // End of mutually exclusive fields.
}
Trường
name

string

Chỉ có đầu ra. Định dạng: name=customers/{customerId}/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 tiện ích Chrome Lưu vào Google Drive, "com.google.android.apps.docs" cho ứng dụng Android Google Drive.

revisionId

string

Chỉ có đầu ra. Phiên bản ứng dụng. 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 phát hành.

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 thông tin 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầ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 khoảng 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í 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 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 một phần của dịch vụ (nếu có).

categoryIds[]

string

Chỉ có đầu ra. Mã danh mục của ứng dụng, giống với mã được lưu trữ trong mục Cửa hàng trực tuyến. Bạn chỉ nên có một mã danh mục.

Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
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.

Kết thúc các trường loại trừ lẫn nhau.

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),
  "riskAssessment": {
    object (RiskAssessmentData)
  },
  "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ố 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ục trong Cửa hàng Chrome trực tuyến

riskAssessment

object (RiskAssessmentData)

Chỉ có đầu ra. Chứa dữ liệu đánh giá rủi ro cho tiện ích Chrome.

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. Liệu ứ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. 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 một ứng dụng có hỗ trợ chính sách cho tiện ích hay không.

manifestVersion

string (int64 format)

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

ChromeAppPermission

Quyền mà 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. 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 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. Trường này có thể chứa các máy chủ lưu trữ hoặc mẫu rất cụ thể, chẳng hạn 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 Chrome.
OTHERS Bất kỳ loại nào khác ngoài tiện ích.

RiskAssessmentData

Dữ liệu đánh giá rủi ro về một tiện ích/ứng dụng.

Biểu diễn dưới dạng JSON
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Trường
entries[]

object (RiskAssessmentEntry)

Đánh giá rủi ro riêng lẻ.

overallRiskLevel

enum (RiskLevel)

Mức độ rủi ro tổng thể được đánh giá trên tất cả các mục. Đây sẽ là mức độ rủi ro cao nhất trong tất cả các mục.

RiskAssessmentEntry

Một mục đánh giá rủi ro.

Biểu diễn dưới dạng JSON
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Trường
provider

enum (RiskAssessmentProvider)

Chỉ có đầu ra. Nhà cung cấp dịch vụ đánh giá rủi ro của mục này.

riskAssessment

object (RiskAssessment)

Chỉ có đầu ra. Thông tin chi tiết về kết quả đánh giá rủi ro của nhà cung cấp.

riskLevel

enum (RiskLevel)

Chỉ có đầu ra. Mức rủi ro được phân nhóm để đánh giá rủi ro.

RiskAssessmentProvider

Nhà cung cấp dịch vụ đánh giá rủi ro.

Enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Giá trị mặc định khi không có nhà cung cấp nào được chỉ định.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR

Không dùng nữa: Vui lòng sử dụng các nhà cung cấp điểm rủi ro khác. CRXcavator.

RISK_ASSESSMENT_PROVIDER_SPIN_AI

Không dùng nữa: Vui lòng sử dụng RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2. Spin.Ai.

RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Đánh giá rủi ro cho một tiện ích Chrome.

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

string

Đánh giá rủi ro của tiện ích. Hiện tại, đây là một giá trị số và cách diễn giải giá trị này tuỳ thuộc vào từng nhà cung cấp dịch vụ đánh giá rủi ro.

detailsUrl

string

Một URL mà người dùng có thể truy cập để biết thêm thông tin về kết quả đánh giá rủi ro.

version

string

Phiên bản của tiện ích mà kết quả đánh giá này áp dụng.

RiskLevel

Mức độ rủi ro được phân nhóm cho một tiện ích/ứng dụng.

Enum
RISK_LEVEL_UNSPECIFIED Chưa chỉ định mức độ rủi ro.
RISK_LEVEL_LOW Tiện ích có rủi ro thấp.
RISK_LEVEL_MEDIUM Tiện ích có mức độ rủi ro trung bình.
RISK_LEVEL_HIGH Tiện ích có rủi ro cao.

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. Yêu cầu cấp quyền của một ứng dụng Android.

AndroidAppPermission

Yêu cầu cấp quyền của một ứng dụng Android.

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

string

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

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 đó.