REST Resource: labels

Zasób: etykieta

Etykieta definiuje taksonomię, którą można zastosować do elementów na Dysku w celu ich porządkowania i wyszukiwania. Etykiety mogą być prostymi ciągami znaków lub zawierać pola opisujące dodatkowe metadane, których można dalej używać do porządkowania i wyszukiwania elementów na Dysku.

Zapis JSON
{
  "name": string,
  "id": string,
  "revisionId": string,
  "labelType": enum (LabelType),
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "revisionCreator": {
    object (UserInfo)
  },
  "revisionCreateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "customer": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedLabelPolicy": {
    object (AppliedLabelPolicy)
  },
  "fields": [
    {
      object (Field)
    }
  ],
  "learnMoreUri": string,
  "lockStatus": {
    object (LockStatus)
  }
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu etykiety. W zależności od żądania może mieć postać labels/{id} lub labels/{id}@{revisionId}. Zobacz id i revisionId poniżej.

id

string

Tylko dane wyjściowe. Niepowtarzalny globalnie identyfikator tej etykiety. Identyfikator stanowi część etykiety name, ale w odróżnieniu od name identyfikator jest spójny między wersjami. Pasuje do wyrażenia regularnego: ([a-zA-Z0-9])+

revisionId

string

Tylko dane wyjściowe. Identyfikator wersji etykiety. W zależności od przesłanej prośby identyfikator wersji może być częścią etykiety name. Nowa wersja jest tworzona po każdej zmianie zmienionych właściwości etykiety. Pasuje do wyrażenia regularnego: ([a-zA-Z0-9])+

labelType

enum (LabelType)

Wymagane. Typ etykiety.

creator

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który utworzył tę etykietę.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tej etykiety.

revisionCreator

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który utworzył tę wersję etykiety.

revisionCreateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tej wersji etykiety.

publisher

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który opublikował tę etykietę. Ta wartość nie ma znaczenia, jeśli etykieta nie jest opublikowana.

publishTime

string (Timestamp format)

Tylko dane wyjściowe. Czas opublikowania tej etykiety. Ta wartość nie ma znaczenia, jeśli etykieta nie jest opublikowana.

disabler

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który wyłączył tę etykietę. Jeśli etykieta nie jest wyłączona, ta wartość nie ma znaczenia.

disableTime

string (Timestamp format)

Tylko dane wyjściowe. Czas wyłączenia tej etykiety. Jeśli etykieta nie jest wyłączona, ta wartość nie ma znaczenia.

customer

string

Tylko dane wyjściowe. Klient, do którego należy ta etykieta. Na przykład: „klienci/123abc789”.

properties

object (Properties)

Wymagane. Podstawowe właściwości etykiety.

lifecycle

object (Lifecycle)

Tylko dane wyjściowe. Stan cyklu życia etykiety, w tym informacje o tym, czy została opublikowana, wycofana i czy zawiera zmiany w wersji roboczej.

displayHints

object (DisplayHints)

Tylko dane wyjściowe. Wyświetlanie w interfejsie wskazówek dotyczących renderowania etykiety.

appliedCapabilities

object (AppliedCapabilities)

Tylko dane wyjściowe. Możliwości związane z tą etykietą w przypadku zastosowanych metadanych.

schemaCapabilities

object (SchemaCapabilities)

Tylko dane wyjściowe. Uprawnienia użytkownika dotyczące tej etykiety.

appliedLabelPolicy

object (AppliedLabelPolicy)

Tylko dane wyjściowe. Działanie tej etykiety po zastosowaniu do elementów na Dysku.

fields[]

object (Field)

Lista pól w kolejności malejącej.

learnMoreUri

string

Niestandardowy adres URL wyświetlany użytkownikom, aby mogli dowiedzieć się więcej o tej etykiecie i sposobie jej używania.

lockStatus

object (LockStatus)

Tylko dane wyjściowe. Stan blokady tej etykiety.

LabelType

Typ etykiety.

Wartości w polu enum
LABEL_TYPE_UNSPECIFIED Nieznany typ etykiety.
SHARED Udostępnione etykiety mogą być udostępniane użytkownikom w celu zastosowania ich do elementów na Dysku.
ADMIN Etykieta należąca do administratora. Mogą być tworzone i edytowane tylko przez administratorów. Obsługuje niektóre dodatkowe funkcje dostępne tylko dla administratorów.

UserInfo

Informacje o użytkowniku.

Zapis JSON
{
  "person": string
}
Pola
person

string

Identyfikator tego użytkownika, którego można użyć z interfejsem People API do uzyskania dodatkowych informacji. Na przykład: osoby/12345678.

Właściwości

Podstawowe właściwości etykiety.

Zapis JSON
{
  "title": string,
  "description": string
}
Pola
title

string

Wymagane. Tytuł etykiety.

description

string

Opis etykiety.

Lifecycle

Stan cyklu życia obiektu, np. etykieta, pole lub wybór. Cykl życia wymusza te przejścia:

  • UNPUBLISHED_DRAFT (stan początkowy)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (Usunięto)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (Usunięto)

Stany opublikowane i wyłączone mają szczególne cechy:

  • Opublikowano – w tym stanie mogą zostać wprowadzone pewne zmiany w obiekcie. W takim przypadku hasUnpublishedChanges ma wartość true (prawda). Ponadto nie zezwalamy na niektóre typy zmian. Odrzucamy wszelkie zmiany, które unieważniłyby lub spowodowałyby wprowadzenie nowych ograniczeń dotyczących istniejących metadanych związanych z etykietą.
  • Wyłączona – jeśli zasada jest wyłączona, stosowana jest skonfigurowana DisabledPolicy.
Zapis JSON
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Pola
state

enum (State)

Tylko dane wyjściowe. Stan obiektu powiązanego z tym cyklem życia.

hasUnpublishedChanges

boolean

Tylko dane wyjściowe. Określa, czy obiekt powiązany z tym cyklem życia ma nieopublikowane zmiany.

disabledPolicy

object (DisabledPolicy)

Zasada określająca sposób wyświetlania wyłączonej etykiety, pola lub opcji wyboru.

Stan

Stan obiektu powiązanego z tym cyklem życia.

Wartości w polu enum
STATE_UNSPECIFIED Stan nieznany.
UNPUBLISHED_DRAFT Początkowy stan obiektu. Po opublikowaniu obiektu nie można już wrócić do tego stanu. Po opublikowaniu obiektu pewne rodzaje zmian nie są już dozwolone.
PUBLISHED Obiekt został opublikowany. Obiekt może zawierać nieopublikowane wersje robocze zmian, które wskazuje hasUnpublishedChanges.
DISABLED Obiekt został opublikowany i od tego czasu jest wyłączony. Obiekt może zawierać nieopublikowane wersje robocze zmian, które wskazuje hasUnpublishedChanges.
DELETED Obiekt został usunięty.

DisabledPolicy

Zasada określająca, jak postępować z wyłączoną etykietą, polem lub wyborem w przypadku wyłączonej opcji w różnych kontekstach.

Zapis JSON
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
Pola
showInApply

boolean

Określa, czy wyświetlać ten wyłączony obiekt w menu Zastosuj przy elementach na Dysku.

  • Gdy true, obiekt jest zwykle wyświetlany w interfejsie jako wyłączony i nie można go wybrać.
  • Gdy obiekt jest używany w interfejsie false, obiekt jest zazwyczaj ukryty w interfejsie.

DisplayHints

Wyświetlanie w interfejsie wskazówek dotyczących renderowania etykiety.

Zapis JSON
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
Pola
disabled

boolean

Określa, czy etykieta ma być wyświetlana w interfejsie jako wyłączona.

shownInApply

boolean

Ta etykieta powinna być widoczna w menu Zastosuj podczas stosowania wartości do elementu na Dysku.

priority

string (int64 format)

Kolejność wyświetlania etykiety na liście.

AppliedCapabilities

Możliwości użytkownika dotyczące zastosowanych metadanych przez tę etykietę.

Zapis JSON
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
Pola
canRead

boolean

Określa, czy użytkownik może odczytać zastosowane metadane powiązane z tą etykietą.

canApply

boolean

Określa, czy użytkownik może stosować tę etykietę do elementów.

canRemove

boolean

Określa, czy użytkownik może usunąć tę etykietę z elementów.

SchemaCapabilities

Możliwości powiązane z tą etykietą podczas jej edytowania.

Zapis JSON
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Pola
canUpdate

boolean

Określa, czy użytkownik może zmienić tę etykietę.

canDelete

boolean

Określa, czy użytkownik może usunąć tę etykietę. Użytkownik musi mieć odpowiednie uprawnienia, a etykieta musi być wyłączona.

canDisable

boolean

Określa, czy użytkownik może wyłączyć tę etykietę. Użytkownik musi mieć odpowiednie uprawnienia, a ta etykieta nie może być wcześniej wyłączona.

canEnable

boolean

Określa, czy użytkownik może włączyć tę etykietę. Użytkownik musi mieć odpowiednie uprawnienia, a ta etykieta musi być wyłączona.

AppliedLabelPolicy

Działanie tej etykiety po zastosowaniu do elementów na Dysku.

Zapis JSON
{
  "copyMode": enum (CopyMode)
}
Pola
copyMode

enum (CopyMode)

Wskazuje sposób kopiowania zastosowanej etykiety i wartości pól podczas kopiowania elementu z Dysku.

CopyMode

Wskazuje sposób kopiowania zastosowanej etykiety i wartości pól podczas kopiowania elementu z Dysku.

Wartości w polu enum
COPY_MODE_UNSPECIFIED Nie określono trybu kopiowania.
DO_NOT_COPY Zastosowane etykiety i wartości pól nie są domyślnie kopiowane podczas kopiowania elementu na Dysku, do którego są zastosowane.
ALWAYS_COPY Zastosowane wartości etykiet i pól są zawsze kopiowane podczas kopiowania elementu na Dysku, do którego są stosowane. Z tego trybu mogą korzystać tylko administratorzy.
COPY_APPLIABLE Zastosowane wartości etykiet i pól są kopiowane, jeśli użytkownik tworzący kopię może zastosować daną etykietę.

Pole

Definiuje pole z wyświetlaną nazwą, typem danych i innymi opcjami konfiguracji. To pole określa rodzaj metadanych, które można ustawić dla elementu na Dysku.

Zapis JSON
{
  "id": string,
  "queryKey": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  },

  // Union field type can be only one of the following:
  "textOptions": {
    object (TextOptions)
  },
  "integerOptions": {
    object (IntegerOptions)
  },
  "dateOptions": {
    object (DateOptions)
  },
  "selectionOptions": {
    object (SelectionOptions)
  },
  "userOptions": {
    object (UserOptions)
  }
  // End of list of possible types for union field type.
}
Pola
id

string

Tylko dane wyjściowe. Klucz pola, unikalny w ramach etykiety lub biblioteki.

Ta wartość jest generowana automatycznie. Pasuje do wyrażenia regularnego: ([a-zA-Z0-9])+

queryKey

string

Tylko dane wyjściowe. Klucz używany podczas tworzenia zapytań na Dysku Google służących do znajdowania plików na podstawie wartości zdefiniowanych dla tego pola. Na przykład: „{queryKey} > 2001-01-01”.

properties

object (Properties)

Podstawowe właściwości pola.

lifecycle

object (Lifecycle)

Tylko dane wyjściowe. Cykl życia tego pola.

displayHints

object (DisplayHints)

Tylko dane wyjściowe. Wskazówki dotyczące renderowania pola w interfejsie.

schemaCapabilities

object (SchemaCapabilities)

Tylko dane wyjściowe. Uprawnienia użytkownika podczas edytowania tego pola.

appliedCapabilities

object (AppliedCapabilities)

Tylko dane wyjściowe. Możliwości użytkownika w tym polu i jego wartość w przypadku zastosowania etykiety do elementów na Dysku.

creator

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który utworzył to pole.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tego pola.

updater

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który zmodyfikował to pole.

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Godzina aktualizacji tego pola.

publisher

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który opublikował to pole. Ta wartość nie ma znaczenia, jeśli pole nie jest opublikowane.

disabler

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który wyłączył to pole. Jeśli pole nie jest wyłączone, ta wartość nie ma znaczenia.

disableTime

string (Timestamp format)

Tylko dane wyjściowe. Czas wyłączenia tego pola. Jeśli pole nie jest wyłączone, ta wartość nie ma znaczenia.

lockStatus

object (LockStatus)

Tylko dane wyjściowe. Stan blokady tego pola.

Pole sumy type. Typ danych i opcje w tym polu. Po opublikowaniu nie można zmienić typu danych. type może mieć tylko jedną z tych wartości:
textOptions

object (TextOptions)

Opcje pola tekstowego.

integerOptions

object (IntegerOptions)

Opcje pól liczby całkowitej.

dateOptions

object (DateOptions)

Opcje pola daty.

selectionOptions

object (SelectionOptions)

Opcje pola wyboru.

userOptions

object (UserOptions)

Opcje pól użytkownika.

TextOptions

Opcje typu pola Tekst.

Zapis JSON
{
  "minLength": integer,
  "maxLength": integer
}
Pola
minLength

integer

Tylko dane wyjściowe. Minimalna prawidłowa długość wartości w polu tekstowym.

maxLength

integer

Tylko dane wyjściowe. Maksymalna prawidłowa długość wartości w polu tekstowym.

IntegerOptions

Opcje typu pola Liczba całkowita.

Zapis JSON
{
  "minValue": string,
  "maxValue": string
}
Pola
minValue

string (int64 format)

Tylko dane wyjściowe. Minimalna prawidłowa wartość pola liczby całkowitej.

maxValue

string (int64 format)

Tylko dane wyjściowe. Maksymalna prawidłowa wartość pola liczby całkowitej.

DateOptions

Opcje typu pola daty.

Zapis JSON
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
Pola
dateFormatType

enum (DateFormat)

Opcja formatowania zlokalizowanej daty. Wartości pól są renderowane w tym formacie zgodnie z ich ustawieniami regionalnymi.

dateFormat

string

Tylko dane wyjściowe. Format daty OIOM-u.

minValue

object (Date)

Tylko dane wyjściowe. Minimalna prawidłowa wartość (rok, miesiąc, dzień).

maxValue

object (Date)

Tylko dane wyjściowe. Maksymalna prawidłowa wartość (rok, miesiąc, dzień).

DateFormat

Opcje formatu zlokalizowanej daty.

Wartości w polu enum
DATE_FORMAT_UNSPECIFIED Nie określono formatu daty.
LONG_DATE Zawiera pełną nazwę miesiąca. Na przykład 12 stycznia 1999 r. (d MMMM y)
SHORT_DATE Krótkie, liczbowe, przedstawianie. Na przykład: 12/13/99 (M/d/RR)

Data

Reprezentuje całą datę lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa zostały określone w innym miejscu lub są nieistotne. Data zależy od kalendarza gregoriańskiego. Może to być jedna z tych wartości:

  • Pełna data z wartościami niezerowymi dotyczącymi roku, miesiąca i dnia.
  • Miesiąc i dzień bez roku (np. rocznica).
  • Sam rok z zerowym miesiącem i zerowym dniem.
  • Rok i miesiąc z zerową datą ważności (np. data ważności karty kredytowej).

Podobne typy:

Zapis JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Wartość musi mieścić się w zakresie od 1 do 9999 lub od 0 do określenia daty bez roku.

month

integer

Miesiąc w roku. Musi mieścić się w zakresie od 1 do 12 lub 0, jeśli chcesz określić rok bez miesiąca i dnia.

day

integer

Dzień miesiąca. Wartość musi należeć do zakresu od 1 do 31 i jest ważna dla roku i miesiąca. Wartość 0 pozwala określić pojedynczy rok lub rok i miesiąc, w którym dzień nie jest istotny.

SelectionOptions

Opcje typu pola wyboru.

Zapis JSON
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
Pola
listOptions

object (ListOptions)

Jeśli to pole jest określone, wskazuje, że to pole obsługuje listę wartości. Po opublikowaniu pola nie można go zmienić.

choices[]

object (Choice)

Opcje dostępne w przypadku tego pola wyboru. Kolejność na liście jest zgodna i zmodyfikowana zgodnie z zasadą insertBeforeChoice.

ListOptions

Opcje wielowartościowego wariantu powiązanego typu pola.

Zapis JSON
{
  "maxEntries": integer
}
Pola
maxEntries

integer

Maksymalna dozwolona liczba wpisów.

Wybór

Wybór pola wyboru.

Zapis JSON
{
  "id": string,
  "properties": {
    object (Properties)
  },
  "lifecycle": {
    object (Lifecycle)
  },
  "displayHints": {
    object (DisplayHints)
  },
  "schemaCapabilities": {
    object (SchemaCapabilities)
  },
  "appliedCapabilities": {
    object (AppliedCapabilities)
  },
  "creator": {
    object (UserInfo)
  },
  "createTime": string,
  "updater": {
    object (UserInfo)
  },
  "updateTime": string,
  "publisher": {
    object (UserInfo)
  },
  "publishTime": string,
  "disabler": {
    object (UserInfo)
  },
  "disableTime": string,
  "lockStatus": {
    object (LockStatus)
  }
}
Pola
id

string

Unikalna wartość wyboru. Ten identyfikator jest generowany automatycznie. Pasuje do wyrażenia regularnego: ([a-zA-Z0-9_])+.

properties

object (Properties)

Podstawowe właściwości.

lifecycle

object (Lifecycle)

Tylko dane wyjściowe. Cykl życia wybranego przez użytkownika.

displayHints

object (DisplayHints)

Tylko dane wyjściowe. Wyświetlanie w interfejsie wskazówek dotyczących renderowania wyboru.

schemaCapabilities

object (SchemaCapabilities)

Tylko dane wyjściowe. Możliwości związane z tą opcją podczas jej edytowania.

appliedCapabilities

object (AppliedCapabilities)

Tylko dane wyjściowe. Możliwości związane z Twoim wyborem w przypadku zastosowanych metadanych.

creator

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który utworzył tę opcję.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Data utworzenia tego wyboru.

updater

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który ostatnio zaktualizował tę opcję.

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Data ostatniej aktualizacji tego wyboru.

publisher

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który opublikował tę opcję. Ta wartość nie ma znaczenia, jeśli wybór nie został opublikowany.

publishTime

string (Timestamp format)

Tylko dane wyjściowe. Data publikacji tego wyboru. Ta wartość nie ma znaczenia, jeśli wybór nie został opublikowany.

disabler

object (UserInfo)

Tylko dane wyjściowe. Użytkownik, który wyłączył tę opcję. Ta wartość nie ma znaczenia, jeśli opcja nie jest wyłączona.

disableTime

string (Timestamp format)

Tylko dane wyjściowe. Czas wyłączenia tej opcji. Ta wartość nie ma znaczenia, jeśli opcja nie jest wyłączona.

lockStatus

object (LockStatus)

Tylko dane wyjściowe. Stan LockStatus tego wyboru.

Właściwości

Podstawowe właściwości.

Zapis JSON
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
Pola
displayName

string

Wymagane. Tekst wyświetlany w interfejsie identyfikującym to pole.

description

string

Opis tej etykiety.

badgeConfig

object (BadgeConfig)

Konfiguracja plakietki dla wybranej opcji. Po ustawieniu etykieta, do której należy ten wybór, jest uważana za „etykietę z plakietką”.

insertBeforeChoice

string

Tylko dane wejściowe. Wstaw lub przenieś tę opcję przed wskazanej powyżej. Jeśli pole jest puste, wybrana opcja zostanie umieszczona na końcu listy.

BadgeConfig

Stan plakietki etykiety.

Zapis JSON
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
Pola
color

object (Color)

Kolor plakietki. Jeśli jej nie określisz, plakietka nie będzie renderowana. Ustawione tutaj kolory tła, pierwszego planu i pojedynczego (trybu jasnego i ciemnego) są zmieniane w interfejsie Dysku na najbliższy zalecany obsługiwany kolor.

priorityOverride

string (int64 format)

Zastąp domyślny priorytet globalny tej plakietki. Gdy ustawisz wartość 0, używana jest domyślna heurystyka priorytetów.

Kolor

Reprezentuje kolor w przestrzeni kolorów RGBA. Ta reprezentacja ma na celu uproszczenie procesu konwersji i zmiany kolorów w różnych językach, a nie ich kompaktowości. Na przykład pola tej reprezentacji można wprost przekazać do konstruktora java.awt.Color w Javie; można go również łatwo dostarczyć do metody +colorWithRed:green:blue:alpha UIColor w systemie iOS. Przy niewielkim nakładzie pracy można go łatwo sformatować pod postacią ciągu CSS rgba() w JavaScripcie.

Na tej stronie referencyjnej nie ma informacji o bezwzględnej przestrzeni kolorów, która powinna być wykorzystywana do interpretacji wartości RGB, np. sRGB, Adobe RGB, DCI-P3 i BT.2020. Domyślnie aplikacje powinny przyjąć przestrzeń kolorów sRGB.

Gdy należy ustalić równość kolorów, implementacje (o ile nie udokumentowano inaczej) traktują 2 kolory jako równe, jeśli wszystkie ich wartości czerwonego, zielonego, niebieskiego i alfa różnią się o maksymalnie 1e-5.

Przykład (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Przykład (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Przykład (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
Zapis JSON
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Pola
red

number

Ilość czerwonego koloru jako wartość z przedziału [0, 1].

green

number

Ilość zielonego koloru jako wartość przedziału [0, 1].

blue

number

Ilość niebieskiego koloru jako wartość z przedziału [0, 1].

alpha

number

Część tego koloru, która powinna zostać zastosowana do piksela. Oznacza to, że końcowy kolor w pikselach jest określony za pomocą tego równania:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Oznacza to, że wartość 1,0 odpowiada jednolitym kolorowi, a wartość 0,0 – kolorowi całkowicie przezroczystemu. Wykorzystuje komunikat opakowany, a nie prosty zmiennoprzecinkowy element skalarny, dzięki czemu można odróżnić wartość domyślną od nieskonfigurowanej wartości. Jeśli ten obiekt koloru zostanie pominięty, będzie on renderowany jako jednolity kolor (jak gdyby wartość alfa miała jednoznacznie przypisaną wartość 1,0).

DisplayHints

Wyświetlanie w interfejsie wskazówek dotyczących renderowania opcji.

Zapis JSON
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
Pola
disabled

boolean

Określa, czy ta opcja ma być wyłączona w interfejsie.

shownInApply

boolean

Ta opcja powinna być widoczna w menu Zastosuj podczas stosowania wartości do elementu na Dysku.

badgeColors

object (BadgeColors)

Kolory logo. Zmieniono na kolory Google Material na podstawie wybranego atrybutu properties.badge_config.color.

darkBadgeColors

object (BadgeColors)

Kolor trybu ciemnego dla plakietki. Zmieniono na kolory Google Material na podstawie wybranego atrybutu properties.badge_config.color.

badgePriority

string (int64 format)

Priorytet tej plakietki. Służy do porównywania wielu plakietek i ich sortowania. Niższa liczba oznacza, że plakietka powinna się wyświetlać jako pierwsza. Jeśli konfiguracja plakietek nie jest dostępna, wartość wynosi 0. W przeciwnym razie zostanie ustawiona wartość BadgeConfig.priority_override lub domyślna heurystyka, która preferuje datę utworzenia etykiety oraz priorytet pola i opcji.

BadgeColors

Kolor uzyskany z BadgeConfig i zmieniony na najbliższy zalecany obsługiwany kolor.

Zapis JSON
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
Pola
backgroundColor

object (Color)

Tylko dane wyjściowe. Tło plakietki dopasowujące się do pierwszego planu.

foregroundColor

object (Color)

Tylko dane wyjściowe. Odznaka na pierwszym planie, który pasuje do tła.

soloColor

object (Color)

Tylko dane wyjściowe. Kolor, którego można użyć w tekście bez tła.

SchemaCapabilities

Funkcje związane z tym wyborem podczas jego edytowania.

Zapis JSON
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Pola
canUpdate

boolean

Określa, czy użytkownik może zmienić tę opcję.

canDelete

boolean

Określa, czy użytkownik może usunąć tę opcję.

canDisable

boolean

Określa, czy użytkownik może wyłączyć tę opcję.

canEnable

boolean

Określa, czy użytkownik może włączyć tę opcję.

AppliedCapabilities

Możliwości związane z Twoim wyborem w przypadku zastosowanych metadanych.

Zapis JSON
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
Pola
canRead

boolean

Określa, czy użytkownik może odczytywać powiązane metadane do elementów.

canSelect

boolean

Określa, czy użytkownik może wybrać tę opcję w elemencie.

LockStatus

Zawiera informacje o tym, czy komponent etykiety powinien być uznawany za zablokowany.

Zapis JSON
{
  "locked": boolean
}
Pola
locked

boolean

Tylko dane wyjściowe. Wskazuje, czy ten komponent etykiety jest (bezpośrednim) celem elementu LabelLock. Komponent etykiety można zablokować domyślnie, nawet jeśli nie jest on bezpośrednim celem elementu LabelLock. W takim przypadku to pole ma wartość false (fałsz).

UserOptions

Opcje typu pola użytkownika.

Zapis JSON
{
  "listOptions": {
    object (ListOptions)
  }
}
Pola
listOptions

object (ListOptions)

Jeśli pole jest określone, wskazuje, że to pole obsługuje listę wartości. Po opublikowaniu pola nie można go zmienić.

Właściwości

Podstawowe właściwości pola.

Zapis JSON
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
Pola
displayName

string

Wymagane. Tekst wyświetlany w interfejsie identyfikującym to pole.

required

boolean

Określa, czy pole powinno być oznaczone jako wymagane.

insertBeforeField

string

Tylko dane wejściowe. Wstaw lub przenieś to pole przed wskazanym polem. Jeśli pole jest puste, znajduje się na końcu listy.

DisplayHints

Wskazówki dotyczące renderowania pola w interfejsie.

Zapis JSON
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
Pola
required

boolean

Określa, czy pole ma być wyświetlane w interfejsie jako wymagane.

disabled

boolean

Określa, czy pole powinno być wyświetlane w interfejsie jako wyłączone.

shownInApply

boolean

To pole powinno być widoczne w menu Zastosuj podczas stosowania wartości do elementu na Dysku.

SchemaCapabilities

Możliwości związane z tym polem podczas jego edytowania.

Zapis JSON
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Pola
canUpdate

boolean

Określa, czy użytkownik może zmienić to pole.

canDelete

boolean

Określa, czy użytkownik może usunąć to pole. Użytkownik musi mieć odpowiednie uprawnienia, a to pole musi być wycofane.

canDisable

boolean

Określa, czy użytkownik może wyłączyć to pole. Użytkownik musi mieć odpowiednie uprawnienia, a to pole nie może być wyłączone.

canEnable

boolean

Określa, czy użytkownik może włączyć to pole. Użytkownik musi mieć odpowiednie uprawnienia, a to pole musi być wyłączone.

AppliedCapabilities

Możliwości związane z tym polem w przypadku zastosowanych metadanych.

Zapis JSON
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
Pola
canRead

boolean

Określa, czy użytkownik może odczytywać powiązane metadane do elementów.

canWrite

boolean

Określa, czy użytkownik może ustawiać to pole w przypadku elementów na Dysku.

Metody

create

Tworzy nową etykietę.

delete

Trwale usuwa etykietę i powiązane z nią metadane elementów na Dysku.

delta

Aktualizuje jedną etykietę, stosując zestaw żądań aktualizacji, co skutkuje nową wersją roboczą.

disable

Wyłącz opublikowaną etykietę.

enable

Włącz wyłączoną etykietę i przywróć ją do stanu opublikowania.

get

Pobierz etykietę na podstawie nazwy jej zasobu.

list

Wyświetl listę etykiet.

publish

Opublikuj wszystkie zmiany wersji roboczej etykiety.

updateLabelCopyMode

Aktualizuje CopyMode etykiety.

updatePermissions

Aktualizuje uprawnienia etykiety.