Products: getAppRestrictionsSchema

Ruft das Schema ab, das die konfigurierbaren Eigenschaften für dieses Produkt definiert. Alle Produkte haben ein Schema. Dieses Schema ist jedoch möglicherweise leer, wenn keine verwalteten Konfigurationen definiert wurden. Mit diesem Schema kann eine UI ausgefüllt werden, mit der ein Administrator das Produkt konfigurieren kann. Informationen zum Anwenden einer verwalteten Konfiguration anhand des Schemas, das mit dieser API abgerufen wurde, finden Sie unter Verwaltete Konfigurationen über Google Play.

Anfragen

HTTP-Anfrage

GET https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/products/productId/appRestrictionsSchema

Parameter

Parametername Wert Beschreibung
Pfadparameter
enterpriseId string Die ID des Unternehmens.
productId string Die ID des Produkts.
Optionale Abfrageparameter
language string Das BCP47-Tag für die bevorzugte Sprache des Nutzers (z. B. „en-US“, „de“)

Autorisierung

Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:

Bereich
https://www.googleapis.com/auth/androidenterprise

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "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)
      ]
    }
  ]
}
Name der Eigenschaft Wert Beschreibung Hinweise
restrictions[] list Die Einschränkungen, aus denen dieses Schema besteht.
restrictions[].key string Der eindeutige Schlüssel, mit dem das Produkt die Einschränkung identifiziert, z.B. „com.google.android.gm.fieldname“.
restrictions[].title string Der Name der Einschränkung.
restrictions[].restrictionType string Die Art der Einschränkung.

Zulässige Werte sind:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
restrictions[].description string Eine ausführlichere Beschreibung der Einschränkung mit weiteren Informationen zu den Auswirkungen.
restrictions[].entry[] list Für Einschränkungen vom Typ choice oder multiselect die Liste der visuell lesbaren Namen möglicher Einträge.
restrictions[].entryValue[] list Für Einschränkungen vom Typ choice oder multiselect die Liste der maschinenlesbaren Werte der möglichen Einträge. Diese Werte sollten in der Konfiguration verwendet werden, entweder als einzelner string-Wert für eine choice-Einschränkung oder in einer stringArray für eine multiselect-Einschränkung.
restrictions[].defaultValue nested object Der Standardwert der Einschränkung. Einschränkungen für bundle und bundleArray haben niemals einen Standardwert.
restrictions[].defaultValue.type string Der Typ des bereitgestellten Werts.

Zulässige Werte sind:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
restrictions[].defaultValue.valueBool boolean Boolescher Wert. Er ist nur vorhanden, wenn der Typ "bool" ist.
restrictions[].defaultValue.valueString string Stringwert: Dieser steht für die Typen „string“, „choice“ und „hidden“ zur Verfügung.
restrictions[].defaultValue.valueInteger integer Ganzzahlwert. Dieser ist nur vorhanden, wenn der Typ eine Ganzzahl ist.
restrictions[].defaultValue.valueMultiselect[] list Die Liste der Stringwerte. Diese ist nur vorhanden, wenn als Typ „Mehrfachauswahl“ ausgewählt wurde.
restrictions[].nestedRestriction[] list Für Einschränkungen vom Typ bundle oder bundleArray die Liste der verschachtelten Einschränkungen. Eine bundle-Einschränkung ist immer in einer bundleArray-Einschränkung verschachtelt und eine bundleArray-Einschränkung hat maximal zwei Ebenen.
kind string Eingestellt.