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 สำหรับผลิตภัณฑ์ สำหรับใช้ในผู้ดูแลระบบขององค์กร

วิธีการ

อนุมัติ

อนุมัติผลิตภัณฑ์ที่ระบุและสิทธิ์ของแอปที่เกี่ยวข้อง (หากมี) จำนวนผลิตภัณฑ์สูงสุดที่คุณสามารถอนุมัติได้ต่อลูกค้าองค์กร 1 รายคือ 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
ค้นหาผลิตภัณฑ์ที่ได้รับอนุมัติซึ่งตรงกับคำค้นหา หรือผลิตภัณฑ์ที่ได้รับอนุมัติทั้งหมด หากไม่มีคำค้นหา หมายเหตุ: รายการนี้เลิกใช้งานแล้ว การผสานรวมใหม่จะใช้วิธีการนี้ไม่ได้และสามารถดู คำแนะนำใหม่ของเราได้
ไม่อนุมัติ
ไม่อนุมัติผลิตภัณฑ์ที่ระบุ (และสิทธิ์ของแอปที่เกี่ยวข้อง หากมี) หมายเหตุ: รายการนี้เลิกใช้งานแล้ว การผสานรวมใหม่จะใช้วิธีการนี้ไม่ได้และสามารถดู คำแนะนำใหม่ของเราได้