Products

ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอแหล่งข้อมูล

ทรัพยากรผลิตภัณฑ์แสดงถึงแอปใน 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 ประเภทของค่าที่ระบุ

ค่าที่ยอมรับได้ มีดังนี้
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "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 ประเภทของข้อจำกัด

ค่าที่ยอมรับได้ มีดังนี้
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "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 แทน

ค่าที่ยอมรับได้ มีดังนี้
  • "alpha"
  • "beta"
  • "production"
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 การจัดประเภทเนื้อหาสำหรับแอปนี้

ค่าที่ยอมรับได้ มีดังนี้
  • "all"
  • "mature"
  • "preTeen"
  • "teen"
description string คำอธิบายโปรโมชันที่แปลแล้ว หากมี
detailsUrl string ลิงก์ไปยังหน้ารายละเอียดผลิตภัณฑ์ Google Play (ผู้บริโภค)
distributionChannel string วิธีการและผู้ที่จะได้รับพัสดุ ค่า publicGoogleHosted หมายความว่าแพ็กเกจพร้อมให้บริการผ่าน Play Store และไม่จำกัดเฉพาะองค์กรบางแห่ง ค่า privateGoogleHosted หมายความว่าแพ็กเกจเป็นแอปส่วนตัว (จำกัดเฉพาะองค์กร) แต่โฮสต์โดย Google ค่า privateSelfHosted หมายความว่าแพ็กเกจเป็นแอปส่วนตัว (จำกัดเฉพาะองค์กร) และโฮสต์แบบส่วนตัว

ค่าที่ยอมรับได้ มีดังนี้
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list ฟีเจอร์ที่น่าสนใจ (หากมี) ของผลิตภัณฑ์นี้
fullDescription string คำอธิบาย App Store แบบเต็มที่มีการแปลภาษา (หากมี)
iarcGenericRating string การจัดประเภทเนื้อหาสำหรับแอปนี้

ค่าที่ยอมรับได้ มีดังนี้
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string ลิงก์ไปยังรูปภาพที่สามารถใช้เป็นไอคอนของผลิตภัณฑ์ รูปภาพนี้เหมาะสำหรับการใช้ที่ความละเอียดไม่เกิน 512 x 512 พิกเซล
kind string
lastUpdatedTimestampMillis long เวลาโดยประมาณ (ภายใน 7 วัน) ที่แอปได้รับการเผยแพร่ครั้งล่าสุด ซึ่งแสดงเป็นมิลลิวินาทีนับตั้งแต่ Epoch
minAndroidSdkVersion integer Android SDK ขั้นต่ำที่จำเป็นต่อการเรียกใช้แอป
permissions[] list รายการสิทธิ์ที่จำเป็นสำหรับแอป
permissions[].permissionId string สตริงที่คลุมเครือที่ระบุสิทธิ์โดยไม่ซ้ำกัน
permissions[].state string สิทธิ์นั้นได้รับการยอมรับหรือไม่

ค่าที่ยอมรับได้ มีดังนี้
  • "accepted"
  • "required"
productId string สตริงของรูปแบบ app:<package name> ตัวอย่างเช่น app:com.google.android.gm แสดงถึงแอป Gmail
productPricing string ผลิตภัณฑ์นี้เป็นแบบฟรี มีการซื้อในแอป หรือต้องซื้อ หากไม่ทราบราคา แสดงว่าผลิตภัณฑ์ดังกล่าวไม่พร้อมให้บริการสำหรับผู้ใช้ทั่วไปอีกต่อไป (แม้ว่าผู้ใช้จะยังเป็นเจ้าของผลิตภัณฑ์ดังกล่าวอยู่ก็ตาม)

ค่าที่ยอมรับได้ มีดังนี้
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
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
ค้นหาผลิตภัณฑ์ที่ได้รับอนุมัติที่ตรงกับคำค้นหาหรือผลิตภัณฑ์ที่ได้รับอนุมัติทั้งหมด หากไม่มีคำค้นหา
ไม่อนุมัติ
ไม่อนุมัติผลิตภัณฑ์ที่ระบุ (และสิทธิ์ของแอปที่เกี่ยวข้อง หากมี)