REST Resource: projects.locations.licenseConfigs

Ressource: LicenseConfig

Informationen zu den Lizenzen von Nutzern.

JSON-Darstellung
{
  "name": string,
  "licenseCount": string,
  "subscriptionTier": enum (SubscriptionTier),
  "state": enum (State),
  "autoRenew": boolean,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "subscriptionTerm": enum (SubscriptionTerm),
  "freeTrial": boolean,
  "geminiBundle": boolean,
  "earlyTerminated": boolean,
  "earlyTerminationDate": {
    object (Date)
  },
  "lastUserUpdateTime": string
}
Felder
name

string

Nicht veränderbar. ID. Der voll qualifizierte Ressourcenname der Lizenzkonfiguration. Format: projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}

licenseCount

string (int64 format)

Erforderlich. Anzahl der erworbenen Lizenzen.

subscriptionTier

enum (SubscriptionTier)

Erforderlich. Informationen zur Abostufe für die Lizenzkonfiguration.

state

enum (State)

Nur Ausgabe. Der Status der Lizenzkonfiguration.

autoRenew

boolean

Optional. Gibt an, ob die Lizenzkonfiguration automatisch verlängert werden soll, wenn das Enddatum erreicht ist.

startDate

object (Date)

Erforderlich. Startdatum.

endDate

object (Date)

Optional. Das geplante Enddatum.

subscriptionTerm

enum (SubscriptionTerm)

Erforderlich. Abolaufzeit.

freeTrial

boolean

Optional. Gibt an, ob die Lizenzkonfiguration für einen kostenlosen Testzeitraum gilt.

geminiBundle

boolean

Nur Ausgabe. Gibt an, ob die Lizenzkonfiguration für das Gemini-Bundle gilt.

earlyTerminated

boolean

Nur Ausgabe. Gibt an, ob das Abo vor dem Ablaufdatum gekündigt wurde. Dies wird in der Regel von der Pipeline beendet, sobald das Abo über subsv3 beendet wird.

earlyTerminationDate

object (Date)

Nur Ausgabe. Das Datum, an dem das Abo vor dem Ablaufdatum gekündigt wird.

lastUserUpdateTime

string (Timestamp format)

Optional: Zeitstempel der letzten vom Nutzer initiierten Aktualisierung (Änderung der Anzahl der Arbeitsplätze oder Änderung der Abolaufzeit). Im Gegensatz zu updateTime wird dieses Feld nur dann eingefügt, wenn ein Kunde die Lizenz explizit aktualisiert (z. B. über die Benutzeroberfläche). Es wird nicht durch systemgesteuerte Schreibvorgänge (Abo-Pipeline, BALC-Weitergabe usw.) geändert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Bundesland

Aufzählung des Status der Lizenzkonfiguration.

Enums
STATE_UNSPECIFIED Standardwert. Die Lizenzkonfiguration ist nicht vorhanden.
ACTIVE Die Lizenzkonfiguration ist aktiv und wird verwendet.
EXPIRED Die Lizenzkonfiguration ist abgelaufen.
NOT_STARTED Die Lizenzkonfiguration hat noch nicht begonnen und ihr Startdatum liegt in der Zukunft.
WITHDRAWN Dies ist der Fall, wenn für eine untergeordnete Lizenzkonfiguration alle zugehörigen Arbeitsplätze an die BillingAccountLicenseConfig zurückgegeben wurden. Ähnlich wie EXPIRED.
DEACTIVATING Die Lizenzkonfiguration befindet sich in einem Kulanzzeitraum. Das Abo ist entweder durch vorzeitige Kündigung oder durch Erreichen des Enddatums abgelaufen, der Kunde hat aber noch für eine begrenzte Zeit Zugriff. Er läuft ab, wenn der Kulanzzeitraum endet.

SubscriptionTerm

Abolaufzeit.

Enums
SUBSCRIPTION_TERM_UNSPECIFIED Standardwert, nicht verwenden.
SUBSCRIPTION_TERM_ONE_MONTH 1 Monat
SUBSCRIPTION_TERM_ONE_YEAR 1 Jahr
SUBSCRIPTION_TERM_THREE_YEARS 3 Jahre
SUBSCRIPTION_TERM_CUSTOM Benutzerdefinierter Begriff Das Enddatum muss festgelegt werden.

Methoden

create

Erstellt eine LicenseConfig Diese Methode sollte nur zum Erstellen von NotebookLM-Lizenzen oder kostenlosen Testlizenzen für Gemini Enterprise verwendet werden.

get

Ruft eine LicenseConfig ab.

list

Listet alle LicenseConfigs auf, die dem Projekt zugeordnet sind.

patch

Aktualisiert die LicenseConfig.