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)
        ]
      }
    ]
  }
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
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,000 รายการ

หากต้องการดูวิธีใช้ Managed Google Play เพื่อออกแบบและสร้างเลย์เอาต์ร้านค้าเพื่อแสดงผลิตภัณฑ์ที่ได้รับอนุมัติแก่ผู้ใช้ โปรดดูการออกแบบเลย์เอาต์ของ Store

generateApprovalUrl
สร้าง URL ที่แสดงผลใน iframe ได้เพื่อแสดงสิทธิ์ (หากมี) ของผลิตภัณฑ์ ผู้ดูแลระบบขององค์กรต้องดูสิทธิ์เหล่านี้และยอมรับในนามขององค์กรจึงจะอนุมัติผลิตภัณฑ์นั้นได้

ผู้ดูแลระบบควรยอมรับสิทธิ์ที่แสดงโดยโต้ตอบกับองค์ประกอบ UI ที่แยกต่างหากในคอนโซล EMM ซึ่งจะส่งผลให้มีการใช้ URL นี้เป็นพร็อพเพอร์ตี้ approvalUrlInfo.approvalUrl ในการเรียกใช้ Products.approve เพื่ออนุมัติผลิตภัณฑ์ คุณใช้ URL นี้เพื่อแสดงสิทธิ์ได้สูงสุด 1 วันเท่านั้น
รับ
เรียกดูรายละเอียดของผลิตภัณฑ์เพื่อแสดงผลต่อผู้ดูแลระบบขององค์กร
getAppRestrictionsSchema
เรียกข้อมูลสคีมาที่กำหนดพร็อพเพอร์ตี้ที่กำหนดค่าได้สำหรับผลิตภัณฑ์นี้ ผลิตภัณฑ์ทั้งหมดมีสคีมา แต่สคีมานี้อาจว่างเปล่าหากไม่มีการกำหนดค่าที่มีการจัดการ สคีมานี้ใช้เพื่อสร้าง UI ที่อนุญาตให้ผู้ดูแลระบบกำหนดค่าผลิตภัณฑ์ได้ หากต้องการใช้การกำหนดค่าที่มีการจัดการตามสคีมาที่ได้รับมาโดยใช้ API นี้ โปรดดูการกำหนดค่าที่มีการจัดการผ่าน Play
getPermissions
เรียกดูสิทธิ์ของแอป Android ที่แอปนี้กำหนด
list
ค้นหาผลิตภัณฑ์ที่ได้รับอนุมัติที่ตรงกับคำค้นหา หรือผลิตภัณฑ์ที่ได้รับอนุมัติทั้งหมดหากไม่มีคำค้นหา
ไม่อนุมัติ
ยกเลิกการอนุมัติผลิตภัณฑ์ที่ระบุ (และสิทธิ์ของแอปที่เกี่ยวข้อง หากมี)