Das benutzerdefinierte Muster wird verwendet, um eine HTTP-Methode anzugeben, die nicht im Musterfeld enthalten ist, z. B. HEAD oder “*”, um die HTTP-Methode für diese Regel nicht anzugeben. Die Platzhalterregel ist nützlich für Dienste, die Webclients (HTML) Inhalte bereitstellen. Wenn eine http-Anmerkung vererbt wird, wird das Pfadmuster wie folgt geändert. Jedes Versionspräfix wird durch die Version der einschließlichschnittstelle plus den Stammpfad ersetzt, falls angegeben. Beachten Sie, wie sich die Version im Pfadmuster von v1 auf v2 geändert hat. Der Selektor ist eine durch Kommas getrennte Liste von Mustern. Jedes Muster ist ein qualifizierter Name des Elements, das auf “*” enden kann, was auf einen Platzhalter hinweist. Wildcards sind nur am Ende und für eine ganze Komponente des qualifizierten Namens zulässig, d.h. “foo.*” ist ok, aber nicht “foo.b*” oder “foo.*.bar”.

Ein Platzhalter entspricht einer oder mehreren Komponenten. Um einen Standardwert für alle anwendbaren Elemente anzugeben, wird das gesamte Muster “*” verwendet. Der Name des Anforderungsfelds, dessen Wert dem HTTP-Anforderungstext zugeordnet ist, oder * für das Zuordnen aller Anforderungsfelder, die nicht vom Pfadmuster erfasst wurden, zum HTTP-Text oder weggelassen, weil kein HTTP-Anforderungstext vorhanden ist. Ein benutzerdefiniertes Muster wird zum Definieren eines benutzerdefinierten HTTP-Verbs verwendet. Verwenden Sie die Back-End-Adresse unverändert, ohne dass der Pfad geändert wird. Wenn das URL-Muster Variablen enthält, werden die Variablennamen und -werte an die Abfragezeichenfolge angehängt. Wenn ein Abfragezeichenfolgenparameter und eine URL-Mustervariable denselben Namen haben, kann dies zu doppelten Schlüsseln in der Abfragezeichenfolge führen. Das Versionsschema verwendet semantische Versionierung, bei der die Hauptversionsnummer eine brechende Änderung und die Nebenversion eine additive, nicht brechende Änderung anzeigt. Beide Versionsnummern sind Signale an Benutzer, was von verschiedenen Versionen zu erwarten ist, und sollten sorgfältig basierend auf dem Produktplan ausgewählt werden. Anforderungen, die erfüllt sein müssen, bevor ein Verbraucherprojekt den Dienst nutzen kann. Jede Anforderung hat das Formular “service.name>/”, z. B.

“serviceusage.googleapis.com/billing-enabled”. Wenn Sie einen Wert von 0 angeben, werden alle Anforderungen blockiert. Dies kann verwendet werden, wenn Sie Kontingentfürkontingente für ausgewählte Verbraucher bereitstellen und andere blockieren. Ebenso gibt ein Wert von -1 ein unbegrenztes Kontingent an. Andere negative Werte sind nicht zulässig. . Allen servicedefinierten Metriken muss der Dienstname im Format “Dienstname” /”relativer Metrikname” vorangestellt werden, z. B. cloudsql.googleapis.com/database/cpu/utilization.

Der relative Metrikname muss folgen: Optional. Benutzersichtbare, erweiterte Beschreibung für dieses Kontingentlimit. Sollte nur verwendet werden, wenn mehr Kontext benötigt wird, um diesen Grenzwert zu verstehen, als durch den Anzeigenamen des Limits bereitgestellt wird (siehe: displayName). Verwenden Sie Transaktionskomponenten in Transaktionsworkflows. Sie ermöglichen es Benutzern, Aktionen zu bestätigen und eine Auswahl zu ermöglichen. Beispielsweise kann eine Reservierungsbestätigung für ein Restaurant es dem Benutzer ermöglichen, die Partygröße und die Reservierungszeit zu ändern. Der eindeutige Bezeichner des auth-Anbieters. Es wird von AuthRequirement.provider_id erwähnt.

Eine eindeutige ID für eine bestimmte Instanz dieser Nachricht, die normalerweise vom Client für die Nachverfolgung zugewiesen wird. Darf nicht länger als 63 Zeichen sein und nur Kleinbuchstaben, Ziffern, `.`, `_` und `-` sind zulässig. Wenn leer, kann der Server stattdessen eine generieren. Die Richtlinie suppress_warning wirkt sich nicht direkt auf die Dokumentation aus und wird zusammen mit der Validierung von Service-Konfigurationsdaten dokumentiert. Eine Liste aller proto-Nachrichtentypen, die in diesem API-Dienst enthalten sind. Es dient ähnlichem Zweck wie google.api.Service.types, mit der Ausnahme, dass diese Typen von benutzerdefinierten APIs nicht benötigt werden. Daher werden sie nicht im generierten Discovery-Dokument angezeigt.