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 des Abozeitraums). Im Gegensatz zu updateTime wird dieses Feld nur eingefügt, wenn ein Kunde die Lizenz explizit aktualisiert (z. B. über die Benutzeroberfläche). Systemgesteuerte Schreibvorgänge (Abo-Pipeline, BALC-Weitergabe usw.) haben keine Auswirkungen auf dieses Feld.

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 eine untergeordnete Lizenzkonfiguration alle ihre Arbeitsplätze an die zugehörige BillingAccountLicenseConfig zurückgegeben hat. Ähnlich wie EXPIRED.
DEACTIVATING Die Lizenzkonfiguration wird vor dem Ablaufdatum beendet und deaktiviert. Der Kunde hat in diesem Status weiterhin Zugriff. Der Status wird in EXPIRED geändert, sobald der Deaktivierungszeitraum (14 Tage) oder das Enddatum erreicht ist – je nachdem, was zuerst eintritt.

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 endDate muss festgelegt werden.

Methoden

create

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

get

 Ruft eine LicenseConfig ab.

list

 Listet alle LicenseConfigs auf, die dem Projekt zugeordnet sind.

patch

 Aktualisiert die LicenseConfig.