ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอแหล่งข้อมูล
ทรัพยากรผลิตภัณฑ์แสดงถึงแอปใน Google Play Store ที่พร้อมให้บริการแก่ผู้ใช้บางกลุ่มในองค์กรเป็นอย่างน้อย (แอปบางส่วนจำกัดไว้เฉพาะองค์กรเดียว และข้อมูลเกี่ยวกับแอปเหล่านั้นไม่พร้อมใช้งานนอกองค์กรนั้น)
ข้อมูลที่ระบุสำหรับผลิตภัณฑ์แต่ละรายการ (ชื่อ ไอคอนที่แปลแล้ว ลิงก์ไปยังหน้ารายละเอียดแบบเต็มของ Google Play) มีไว้เพื่อให้ข้อมูลพื้นฐานของผลิตภัณฑ์ภายในอินเทอร์เฟซผู้ใช้ EMM
{ "kind": "androidenterprise#product", "productId": string, "title": string, "authorName": string, "iconUrl": string, "smallIconUrl": string, "detailsUrl": string, "workDetailsUrl": string, "requiresContainerApp": boolean, "appVersion": [ { "versionString": string, "versionCode": integer, "track": string, "targetSdkVersion": integer, "trackId": [ string ], "isProduction": boolean } ], "distributionChannel": string, "productPricing": string, "signingCertificate": { "certificateHashSha256": string, "certificateHashSha1": string }, "availableTracks": [ string ], "appTracks": [ { "trackId": string, "trackAlias": string } ], "description": string, "fullDescription": string, "screenshotUrls": [ string ], "category": string, "recentChanges": string, "minAndroidSdkVersion": integer, "contentRating": string, "lastUpdatedTimestampMillis": long, "permissions": [ { "permissionId": string, "state": string } ], "availableCountries": [ string ], "features": [ string ], "iarcGenericRating": string, "appRestrictionsSchema": { "kind": string, "restrictions": [ { "key": string, "title": string, "restrictionType": string, "description": string, "entry": [ string ], "entryValue": [ string ], "defaultValue": { "type": string, "valueBool": boolean, "valueString": string, "valueInteger": integer, "valueMultiselect": [ string ] }, "nestedRestriction": [ (AppRestrictionsSchemaRestriction) ] } ] } }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
appRestrictionsSchema |
nested object |
สคีมาข้อจำกัดของแอป | |
appRestrictionsSchema.kind |
string |
เลิกใช้งานแล้ว |
|
appRestrictionsSchema.restrictions[] |
list |
ชุดของข้อจำกัดที่ประกอบขึ้นเป็นสคีมานี้ | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
ค่าเริ่มต้นของข้อจำกัด การจำกัด bundle และ bundleArray ไม่มีค่าเริ่มต้น |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
ประเภทของค่าที่ระบุ
ค่าที่ยอมรับได้ มีดังนี้
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
ค่าบูลีน - ค่านี้จะแสดงเมื่อประเภทเป็นบูลีนเท่านั้น | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
ค่าจำนวนเต็ม - ค่านี้จะปรากฏก็ต่อเมื่อประเภทเป็นจำนวนเต็ม | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
รายการค่าสตริง - จะปรากฏต่อเมื่อประเภทคือการเลือกหลายรายการเท่านั้น | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
ค่าสตริง - ค่านี้จะปรากฏสำหรับสตริงประเภท ตัวเลือก และค่าที่ซ่อน | |
appRestrictionsSchema.restrictions[].description |
string |
คำอธิบายข้อจำกัดที่ยาวขึ้น ให้รายละเอียดเพิ่มเติมเกี่ยวกับผลกระทบจากผลกระทบ | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
สำหรับข้อจำกัด choice หรือ multiselect รายการที่เป็นไปได้ ที่เครื่องอ่านได้ ควรใช้ค่าเหล่านี้ในการกำหนดค่า ไม่ว่าจะเป็นค่า string ค่าเดียวสำหรับข้อจำกัด choice หรือใน stringArray สำหรับข้อจำกัด multiselect |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
สำหรับข้อจำกัด choice หรือ multiselect รายการที่เป็นไปได้ ชื่อที่มนุษย์อ่านได้ |
|
appRestrictionsSchema.restrictions[].key |
string |
คีย์ที่ไม่ซ้ำกันที่ผลิตภัณฑ์ใช้ในการระบุข้อจำกัด เช่น "com.google.android.gm.fieldname" | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
สำหรับข้อจำกัด bundle หรือ bundleArray รายการข้อจำกัดที่ฝังอยู่ การจำกัด bundle จะซ้อนอยู่ในการจำกัด bundleArray เสมอ และการจำกัด bundleArray มีความลึกไม่เกิน 2 ระดับ |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
ประเภทของข้อจำกัด
ค่าที่ยอมรับได้ มีดังนี้
|
|
appRestrictionsSchema.restrictions[].title |
string |
ชื่อของข้อจำกัด | |
appTracks[] |
list |
แทร็กที่องค์กรมองเห็น | |
appTracks[].trackAlias |
string |
ชื่อที่แก้ไขได้สำหรับแทร็ก นี่คือชื่อที่ปรากฏใน Play Developer Console | |
appTracks[].trackId |
string |
ตัวระบุแทร็กที่ไม่ซ้ำกันซึ่งแก้ไขไม่ได้ ตัวระบุนี้คือ ReleaseTrackId ใน URL ของหน้า Play Developer Console ที่แสดงข้อมูลแทร็ก | |
appVersion[] |
list |
เวอร์ชันแอปที่พร้อมให้บริการสำหรับผลิตภัณฑ์นี้ในปัจจุบัน | |
appVersion[].isProduction |
boolean |
เป็นจริงหากเวอร์ชันนี้เป็น APK เวอร์ชันที่ใช้งานจริง | |
appVersion[].targetSdkVersion |
integer |
SDK เวอร์ชันที่แอปนี้กำหนดเป้าหมาย ตามที่ระบุไว้ในไฟล์ Manifest ของ APK โปรดดู http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
เลิกใช้งานแล้ว โปรดใช้ trackId แทน
ค่าที่ยอมรับได้ มีดังนี้
|
|
appVersion[].trackId[] |
list |
รหัสการติดตามที่มีการเผยแพร่เวอร์ชันแอป แทนที่ช่อง track (เลิกใช้งานแล้ว) แต่ไม่รวมแทร็กเวอร์ชันที่ใช้งานจริง (ดู isProduction แทน) |
|
appVersion[].versionCode |
integer |
ตัวระบุที่เพิ่มขึ้นที่ไม่ซ้ำกันสำหรับเวอร์ชันแอป | |
appVersion[].versionString |
string |
สตริงที่นักพัฒนาแอปใช้ใน Play Store เพื่อระบุเวอร์ชัน สตริงไม่จำเป็นต้องไม่ซ้ำกันหรือแปลเป็นภาษาท้องถิ่น (เช่น สตริงอาจเป็น "1.4") | |
authorName |
string |
ชื่อของผู้เขียนผลิตภัณฑ์ (เช่น นักพัฒนาแอป) | |
availableCountries[] |
list |
ประเทศที่แอปนี้ให้บริการ | |
availableTracks[] |
list |
เลิกใช้งานแล้ว โปรดใช้ appTracks แทน |
|
category |
string |
หมวดหมู่แอป (เช่น RACING, SOCIAL ฯลฯ) | |
contentRating |
string |
การจัดประเภทเนื้อหาสำหรับแอปนี้
ค่าที่ยอมรับได้ มีดังนี้
|
|
description |
string |
คำอธิบายโปรโมชันที่แปลแล้ว หากมี | |
detailsUrl |
string |
ลิงก์ไปยังหน้ารายละเอียดผลิตภัณฑ์ Google Play (ผู้บริโภค) | |
distributionChannel |
string |
วิธีการและผู้ที่จะได้รับพัสดุ ค่า publicGoogleHosted หมายความว่าแพ็กเกจพร้อมให้บริการผ่าน Play Store และไม่จำกัดเฉพาะองค์กรบางแห่ง ค่า privateGoogleHosted หมายความว่าแพ็กเกจเป็นแอปส่วนตัว (จำกัดเฉพาะองค์กร) แต่โฮสต์โดย Google ค่า privateSelfHosted หมายความว่าแพ็กเกจเป็นแอปส่วนตัว (จำกัดเฉพาะองค์กร) และโฮสต์แบบส่วนตัว
ค่าที่ยอมรับได้ มีดังนี้
|
|
features[] |
list |
ฟีเจอร์ที่น่าสนใจ (หากมี) ของผลิตภัณฑ์นี้ | |
fullDescription |
string |
คำอธิบาย App Store แบบเต็มที่มีการแปลภาษา (หากมี) | |
iarcGenericRating |
string |
การจัดประเภทเนื้อหาสำหรับแอปนี้
ค่าที่ยอมรับได้ มีดังนี้
|
|
iconUrl |
string |
ลิงก์ไปยังรูปภาพที่สามารถใช้เป็นไอคอนของผลิตภัณฑ์ รูปภาพนี้เหมาะสำหรับการใช้ที่ความละเอียดไม่เกิน 512 x 512 พิกเซล | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
เวลาโดยประมาณ (ภายใน 7 วัน) ที่แอปได้รับการเผยแพร่ครั้งล่าสุด ซึ่งแสดงเป็นมิลลิวินาทีนับตั้งแต่ Epoch | |
minAndroidSdkVersion |
integer |
Android SDK ขั้นต่ำที่จำเป็นต่อการเรียกใช้แอป | |
permissions[] |
list |
รายการสิทธิ์ที่จำเป็นสำหรับแอป | |
permissions[].permissionId |
string |
สตริงที่คลุมเครือที่ระบุสิทธิ์โดยไม่ซ้ำกัน | |
permissions[].state |
string |
สิทธิ์นั้นได้รับการยอมรับหรือไม่
ค่าที่ยอมรับได้ มีดังนี้
|
|
productId |
string |
สตริงของรูปแบบ app:<package name> ตัวอย่างเช่น app:com.google.android.gm แสดงถึงแอป Gmail |
|
productPricing |
string |
ผลิตภัณฑ์นี้เป็นแบบฟรี มีการซื้อในแอป หรือต้องซื้อ หากไม่ทราบราคา แสดงว่าผลิตภัณฑ์ดังกล่าวไม่พร้อมให้บริการสำหรับผู้ใช้ทั่วไปอีกต่อไป (แม้ว่าผู้ใช้จะยังเป็นเจ้าของผลิตภัณฑ์ดังกล่าวอยู่ก็ตาม)
ค่าที่ยอมรับได้ มีดังนี้
|
|
recentChanges |
string |
คำอธิบายการเปลี่ยนแปลงล่าสุดที่เกิดขึ้นกับแอป | |
requiresContainerApp |
boolean |
เลิกใช้งานแล้ว | |
screenshotUrls[] |
list |
รายการลิงก์ภาพหน้าจอที่แสดงแอป | |
signingCertificate |
nested object |
ใบรับรองที่ใช้ลงนามผลิตภัณฑ์นี้ | |
signingCertificate.certificateHashSha1 |
string |
แฮช SHA1 ที่เข้ารหัส base64 urlsafe ของใบรับรอง (ช่องนี้เลิกใช้งานแล้วเพื่อใช้ SHA2-256 ไม่ควรนำข้อมูลดังกล่าวไปใช้และอาจนำออกได้ทุกเมื่อ) |
|
signingCertificate.certificateHashSha256 |
string |
แฮช SHA2-256 ที่เข้ารหัส base64 urlsafe ของใบรับรอง | |
smallIconUrl |
string |
ลิงก์ไปยังรูปภาพขนาดเล็กที่สามารถใช้เป็นไอคอนของผลิตภัณฑ์ได้ รูปภาพนี้เหมาะสำหรับการใช้ที่ความละเอียดไม่เกิน 128 x 128 พิกเซล | |
title |
string |
ชื่อผลิตภัณฑ์ | |
workDetailsUrl |
string |
ลิงก์ไปยังหน้ารายละเอียด Managed Google Play สำหรับผลิตภัณฑ์ สำหรับให้ผู้ดูแลระบบ Enterprise นำไปใช้ |
เมธอด
- อนุมัติ
-
อนุมัติผลิตภัณฑ์ที่ระบุและสิทธิ์ของแอปที่เกี่ยวข้อง (หากมี) จำนวนผลิตภัณฑ์สูงสุดที่คุณสามารถอนุมัติต่อลูกค้าองค์กร 1 ราย ที่สูงถึง 1,000 ฉบับ
เพื่อดูวิธีใช้ Managed Google Play เพื่อออกแบบและสร้างร้านค้า เพื่อแสดงผลิตภัณฑ์ที่ได้รับอนุมัติแก่ผู้ใช้ ดูการออกแบบเลย์เอาต์ของร้านค้า
- generateApprovalUrl
-
สร้าง URL ที่สามารถแสดงผลใน iframe เพื่อแสดง
สิทธิ์ (หากมี) ของผลิตภัณฑ์ ผู้ดูแลระบบขององค์กรต้องดูข้อมูลเหล่านี้
และยอมรับในนามขององค์กรเพื่อทำสิ่งต่อไปนี้
อนุมัติผลิตภัณฑ์นั้น
ผู้ดูแลระบบควรยอมรับสิทธิ์ที่แสดงโดย โต้ตอบกับองค์ประกอบ UI แยกต่างหากในคอนโซล EMM ซึ่งทำให้ ควรทริกเกอร์การใช้ URL นี้เป็น พร็อพเพอร์ตี้approvalUrlInfo.approvalUrl
ในProducts.approve
การเรียกเพื่ออนุมัติผลิตภัณฑ์ คุณใช้ URL นี้เพื่อแสดงสิทธิ์ได้สูงสุด 1 วันเท่านั้น - รับ
- เรียกดูรายละเอียดของผลิตภัณฑ์เพื่อแสดงผลต่อผู้ดูแลระบบขององค์กร
- getAppRestrictionsSchema
- เรียกข้อมูลสคีมาที่กำหนดพร็อพเพอร์ตี้ที่กำหนดค่าได้สำหรับการดำเนินการนี้ ผลิตภัณฑ์ ผลิตภัณฑ์ทั้งหมดมีสคีมา แต่สคีมานี้อาจว่างเปล่าหากไม่มีสคีมา มีการกำหนดการกำหนดค่าที่มีการจัดการแล้ว สคีมานี้สามารถใช้เพื่อ ป้อนข้อมูล UI ที่ช่วยให้ผู้ดูแลระบบกำหนดค่าผลิตภัณฑ์ได้ หากต้องการใช้การกำหนดค่าที่มีการจัดการตามสคีมาที่ได้รับจากการใช้การกำหนดค่านี้ API โปรดดู การกำหนดค่าที่มีการจัดการผ่าน Play
- getPermissions
- ดึงสิทธิ์ของแอป Android ที่จําเป็นสําหรับแอปนี้
- list
- ค้นหาผลิตภัณฑ์ที่ได้รับอนุมัติที่ตรงกับคำค้นหาหรือผลิตภัณฑ์ที่ได้รับอนุมัติทั้งหมด หากไม่มีคำค้นหา
- ไม่อนุมัติ
- ไม่อนุมัติผลิตภัณฑ์ที่ระบุ (และสิทธิ์ของแอปที่เกี่ยวข้อง หากมี)