REST Resource: labels

Kaynak: Etiket

Etiket, öğeleri düzenlemek ve öğeler arasında arama yapmak için Drive öğelerine uygulanabilen bir sınıflandırma tanımlar. Etiketler basit dizeler olabilir veya Drive öğelerini düzenlemek ve aramak için daha fazla kullanılabilecek ek meta verileri açıklayan alanlar içerebilir.

JSON gösterimi 
{
  "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)
  },
  "enabledAppSettings": {
    object (EnabledAppSettings)
  }
}
Alanlar
name

string

Yalnızca çıkış. Etiketin kaynak adı. İsteğe bağlı olarak labels/{id} veya labels/{id}@{revisionId} biçiminde olacaktır. Aşağıdaki id ve revisionId hükümlerini inceleyin.
id

string

Yalnızca çıkış. Bu etiketin genel olarak benzersiz tanımlayıcısı. Kimlik, name etiketinin bir bölümünü oluşturur ancak name'dan farklı olarak kimlik, düzeltmeler arasında tutarlıdır. Şu normal ifadeyle eşleşir: ([a-zA-Z0-9])+.
revisionId

string

Yalnızca çıkış. Etiketin düzeltme kimliği. Düzeltme kimliği, gönderilen isteğe bağlı olarak name etiketinin bir parçası olabilir. Bir etiketin revize edilmiş özellikleri her değiştirildiğinde yeni bir revizyon oluşturulur. Şu normal ifadeyle eşleşir: ([a-zA-Z0-9])+.
labelType

enum (LabelType)

Zorunlu. Etiketin türü.
creator

object (UserInfo)

Yalnızca çıkış. Bu etiketi oluşturan kullanıcı.
createTime

string (Timestamp format)

Yalnızca çıkış. Bu etiketin oluşturulma zamanı.
revisionCreator

object (UserInfo)

Yalnızca çıkış. Bu etiket düzeltmesini oluşturan kullanıcı.
revisionCreateTime

string (Timestamp format)

Yalnızca çıkış. Bu etiket düzeltmesinin oluşturulduğu zaman.
publisher

object (UserInfo)

Yalnızca çıkış. Bu etiketi yayınlayan kullanıcı. Etiket yayınlanmadığında bu değerin bir anlamı yoktur.
publishTime

string (Timestamp format)

Yalnızca çıkış. Bu etiketin yayınlandığı zaman. Etiket yayınlanmadığında bu değerin bir anlamı yoktur.
disabler

object (UserInfo)

Yalnızca çıkış. Bu etiketi devre dışı bırakan kullanıcı. Etiket devre dışı bırakılmadığında bu değerin bir anlamı yoktur.
disableTime

string (Timestamp format)

Yalnızca çıkış. Bu etiketin devre dışı bırakıldığı zaman. Etiket devre dışı bırakılmadığında bu değerin bir anlamı yoktur.
customer

string

Yalnızca çıkış. Bu etiketin ait olduğu müşteri. Örneğin: customers/123abc789.
properties

object (Properties)

Zorunlu. Etiketin temel özellikleri.
lifecycle

object (Lifecycle)

Yalnızca çıkış. Etiketin yaşam döngüsü durumu (ör. yayınlanmış, kullanımdan kaldırılmış ve taslak değişiklikler içeriyor).
displayHints

object (DisplayHints)

Yalnızca çıkış. Etiketin oluşturulması için kullanıcı arayüzü görüntüleme ipuçları.
appliedCapabilities

object (AppliedCapabilities)

Yalnızca çıkış. Uygulanan meta verilerdeki bu etiketle ilgili özellikler.
schemaCapabilities

object (SchemaCapabilities)

Yalnızca çıkış. Kullanıcının bu etiketteki özellikleri.
appliedLabelPolicy

object (AppliedLabelPolicy)

Yalnızca çıkış. Bu etiket Drive öğelerine uygulandığında nasıl davranır?
fields[]

object (Field)

Alanların öncelik sırasına göre azalan düzende listesi.
learnMoreUri

string

Kullanıcılara sunulacak özel URL. Bu URL'yi ziyaret eden kullanıcılar, söz konusu etiket ve nasıl kullanılması gerektiği hakkında daha fazla bilgi edinebilir.
lockStatus

object (LockStatus)

Yalnızca çıkış. Bu etiketin LockStatus.
enabledAppSettings

object (EnabledAppSettings)

İsteğe bağlı. Bu Etiketin EnabledAppSettings.

LabelType

Bu etiketin türü.

Sıralamalar
LABEL_TYPE_UNSPECIFIED Bilinmeyen etiket türü.
SHARED Paylaşılan etiketler, Drive öğelerine uygulanmak üzere kullanıcılarla paylaşılabilir.
ADMIN Yöneticiye ait etiket. Yalnızca yöneticiler tarafından oluşturulabilir ve düzenlenebilir. Yalnızca yöneticilere yönelik bazı ek özellikleri destekler.
GOOGLE_APP Müşteriye değil, dahili bir Google uygulamasına ait olan etiket. Bu etiketler salt okunurdur.

UserInfo

Kullanıcı hakkında bilgiler.

JSON gösterimi 
{
  "person": string
}
Alanlar
person

string

Bu kullanıcı için tanımlayıcı. Daha fazla bilgi edinmek üzere People API ile kullanılabilir. Örneğin, people/12345678.

Özellikler

Etiketin temel özellikleri.

JSON gösterimi 
{
  "title": string,
  "description": string
}
Alanlar
title

string

Zorunlu. Etiketin başlığı.
description

string

Etiketin açıklaması.

Yaşam döngüsü

Etiket, alan veya seçenek gibi bir nesnenin yaşam döngüsü durumu. Daha fazla bilgi için Etiket yaşam döngüsü başlıklı makaleyi inceleyin.

Yaşam döngüsünde aşağıdaki geçişler zorunlu kılınır:

  • UNPUBLISHED_DRAFT (başlangıç durumu)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (Silindi)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (Silindi)

Yayınlanmış ve devre dışı bırakılmış durumların bazı belirgin özellikleri vardır:

  • Published: Bu durumdaki bir nesnede bazı değişiklikler yapılabilir. Bu durumda hasUnpublishedChanges doğru olur. Ayrıca, bazı değişiklik türlerine izin verilmez. Genel olarak, etiketle ilgili mevcut meta verileri geçersiz kılacak veya yeni kısıtlamalara neden olacak tüm değişiklikler reddedilir.
  • Disabled: Devre dışı bırakıldığında, yapılandırılan DisabledPolicy geçerli olur.
JSON gösterimi 
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Alanlar
state

enum (State)

Yalnızca çıkış. Bu yaşam döngüsüyle ilişkili nesnenin durumu.
hasUnpublishedChanges

boolean

Yalnızca çıkış. Bu yaşam döngüsüyle ilişkili nesnede yayınlanmamış değişiklikler olup olmadığı.
disabledPolicy

object (DisabledPolicy)

Devre dışı bırakılmış bir etiketin, alanın veya seçim seçeneğinin nasıl gösterileceğini yöneten politika.

Eyalet

Bu yaşam döngüsüyle ilişkili nesnenin durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmeyen durum.
UNPUBLISHED_DRAFT Bir nesnenin başlangıç durumu. Yayınlanan nesne bir daha bu duruma geri dönemez. Bir nesne yayınlandıktan sonra belirli değişikliklere izin verilmez.
PUBLISHED Nesne yayınlandı. Nesnede, hasUnpublishedChanges ile belirtildiği gibi yayınlanmamış taslak değişiklikler olabilir.
DISABLED Nesne yayınlandıktan sonra devre dışı bırakılmış. Nesnede, hasUnpublishedChanges ile belirtildiği gibi yayınlanmamış taslak değişiklikler olabilir.
DELETED Nesne silindi.

DisabledPolicy

Farklı bağlamlarda devre dışı bırakılmış bir etiketin, alanın veya seçim seçeneğinin nasıl ele alınacağını yöneten politika.

JSON gösterimi 
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
Alanlar
showInApply

boolean

Bu devre dışı bırakılmış nesnenin, Drive öğelerindeki uygulama menüsünde gösterilip gösterilmeyeceğini belirler.

  • true olduğunda nesne genellikle kullanıcı arayüzünde devre dışı olarak gösterilir ve seçilemez.
  • false olduğunda nesne genellikle kullanıcı arayüzünde gizlenir.

DisplayHints

Etiketin oluşturulması için kullanıcı arayüzü görüntüleme ipuçları.

JSON gösterimi 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
Alanlar
disabled

boolean

Etiketin kullanıcı arayüzünde devre dışı olarak gösterilip gösterilmeyeceği.
shownInApply

boolean

Bu etiket, Drive öğesine değer uygulanırken uygulama menüsünde gösterilmelidir.
priority

string (int64 format)

Etiketlerin listede gösterilme sırası.

AppliedCapabilities

Kullanıcının bu etiketin uygulanan meta verilerinde sahip olduğu özellikler.

JSON gösterimi 
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
Alanlar
canRead

boolean

Kullanıcının bu etiketle ilgili uygulanan meta verileri okuyup okuyamayacağı.
canApply

boolean

Kullanıcının bu etiketi öğelere uygulayıp uygulayamayacağı.
canRemove

boolean

Kullanıcının bu etiketi öğelerden kaldırıp kaldıramayacağı.

SchemaCapabilities

Etiketi düzenlerken bu etiketle ilgili özellikler.

JSON gösterimi 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Alanlar
canUpdate

boolean

Kullanıcının bu etiketi değiştirip değiştiremeyeceği.
canDelete

boolean

Kullanıcının bu etiketi silip silemeyeceği. Kullanıcının izni olmalı ve etiket devre dışı bırakılmalıdır.
canDisable

boolean

Kullanıcının bu etiketi devre dışı bırakıp bırakamayacağı. Kullanıcının izni olmalı ve bu etiket devre dışı bırakılmamış olmalıdır.
canEnable

boolean

Kullanıcının bu etiketi etkinleştirip etkinleştiremeyeceği. Kullanıcının izni olmalı ve bu etiket devre dışı bırakılmalıdır.

AppliedLabelPolicy

Bu etiket Drive öğelerine uygulandığında nasıl davranır?

JSON gösterimi 
{
  "copyMode": enum (CopyMode)
}
Alanlar
copyMode

enum (CopyMode)

Bir Drive öğesi kopyalandığında uygulanan etiket ve alan değerlerinin nasıl kopyalanacağını gösterir.

CopyMode

Bir Drive öğesi kopyalandığında uygulanan etiket ve alan değerlerinin nasıl kopyalanacağını gösterir.

Sıralamalar
COPY_MODE_UNSPECIFIED Kopyalama modu belirtilmemiş.
DO_NOT_COPY Uygulanan etiket ve alan değerleri, uygulandığı Drive öğesi kopyalandığında varsayılan olarak kopyalanmaz.
ALWAYS_COPY Uygulanan etiket ve alan değerleri, uygulandığı Drive öğesi kopyalandığında her zaman kopyalanır. Bu modu yalnızca yöneticiler kullanabilir.
COPY_APPLIABLE Uygulanan etiket ve alan değerleri, etiketin kopyayı oluşturan kullanıcı tarafından uygulanabilir olması durumunda kopyalanır.

Alan

Görünen adı, veri türü ve diğer yapılandırma seçenekleri olan bir alanı tanımlar. Bu alan, bir Drive öğesinde ayarlanabilecek meta veri türünü tanımlar.

JSON gösterimi 
{
  "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.
}
Alanlar
id

string

Yalnızca çıkış. Bir alanın; bir etiket veya kitaplık içinde benzersiz olan anahtarı.

Bu değer otomatik olarak oluşturulur. Şu normal ifadeyle eşleşir: ([a-zA-Z0-9])+.
queryKey

string

Yalnızca çıkış. Dosyalarda bu alan için tanımlanan değerlere göre dosya bulmak üzere Drive arama sorguları oluştururken kullanılacak anahtar. Örneğin, "{queryKey} > 2001-01-01".
properties

object (Properties)

Alanın temel özellikleri.
lifecycle

object (Lifecycle)

Yalnızca çıkış. Bu alanın yaşam döngüsü.
displayHints

object (DisplayHints)

Yalnızca çıkış. Bir alanı oluşturmak için kullanıcı arayüzü görüntüleme ipuçları.
schemaCapabilities

object (SchemaCapabilities)

Yalnızca çıkış. Bu kullanıcının bu alanı düzenlerken sahip olduğu özellikler.
appliedCapabilities

object (AppliedCapabilities)

Yalnızca çıkış. Bu kullanıcının bu alandaki özellikleri ve etiket Drive öğelerine uygulandığında alanın değeri.
creator

object (UserInfo)

Yalnızca çıkış. Bu alanı oluşturan kullanıcı.
createTime

string (Timestamp format)

Yalnızca çıkış. Bu alanın oluşturulma zamanı.
updater

object (UserInfo)

Yalnızca çıkış. Bu alanı değiştiren kullanıcı.
updateTime

string (Timestamp format)

Yalnızca çıkış. Bu alanın güncellenme zamanı.
publisher

object (UserInfo)

Yalnızca çıkış. Bu alanı yayınlayan kullanıcı. Alan yayınlanmadığında bu değerin bir anlamı yoktur.
disabler

object (UserInfo)

Yalnızca çıkış. Bu alanı devre dışı bırakan kullanıcı. Alan devre dışı bırakılmadığında bu değerin bir anlamı yoktur.
disableTime

string (Timestamp format)

Yalnızca çıkış. Bu alanın devre dışı bırakıldığı zaman. Alan devre dışı bırakılmadığında bu değerin bir anlamı yoktur.
lockStatus

object (LockStatus)

Yalnızca çıkış. Bu alanın LockStatus.
Birleştirme alanı type. Bu alanın veri türü ve seçenekleri. Yayınlandıktan sonra veri türü değiştirilemez. type yalnızca aşağıdakilerden biri olabilir:
textOptions

object (TextOptions)

Metin alanı seçenekleri.
integerOptions

object (IntegerOptions)

Tam sayı alanı seçenekleri.
dateOptions

object (DateOptions)

Tarih alanı seçenekleri.
selectionOptions

object (SelectionOptions)

Seçim alanı seçenekleri.
userOptions

object (UserOptions)

Kullanıcı alanı seçenekleri.

TextOptions

Metin alanı türü için seçenekler.

JSON gösterimi 
{
  "minLength": integer,
  "maxLength": integer
}
Alanlar
minLength

integer

Yalnızca çıkış. Metin alanındaki değerlerin minimum geçerli uzunluğu.
maxLength

integer

Yalnızca çıkış. Metin alanı değerlerinin maksimum geçerli uzunluğu.

IntegerOptions

Tam sayı alanı türü için seçenekler.

JSON gösterimi 
{
  "minValue": string,
  "maxValue": string
}
Alanlar
minValue

string (int64 format)

Yalnızca çıkış. Tam sayı alanı için geçerli minimum değer.
maxValue

string (int64 format)

Yalnızca çıkış. Tam sayı alanı için geçerli maksimum değer.

DateOptions

Tarih alanı türü için seçenekler.

JSON gösterimi 
{
  "dateFormatType": enum (DateFormat),
  "dateFormat": string,
  "minValue": {
    object (Date)
  },
  "maxValue": {
    object (Date)
  }
}
Alanlar
dateFormatType

enum (DateFormat)

Yerelleştirilmiş tarih biçimlendirme seçeneği. Alan değerleri, yerel ayarlarına göre bu biçimde oluşturulur.
dateFormat

string

Yalnızca çıkış. ICU tarih biçimi.
minValue

object (Date)

Yalnızca çıkış. Geçerli minimum değer (yıl, ay, gün).
maxValue

object (Date)

Yalnızca çıkış. Maksimum geçerli değer (yıl, ay, gün).

DateFormat

Yerelleştirilmiş tarih biçimi seçenekleri.

Sıralamalar
DATE_FORMAT_UNSPECIFIED Tarih biçimi belirtilmemiş.
LONG_DATE Ayın tam adını içerir. Örneğin, 12 Ocak 1999 (MMMM d, y)
SHORT_DATE Kısa, sayısal gösterim. Örneğin, 13/12/99 (A/G/YY)

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Ay ve gün, sıfır yılıyla (örneğin, yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Bir yıl ve ay, sıfır günle (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalıdır veya ay ve gün içermeyen bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

SelectionOptions

Seçim alanı türü seçenekleri.

JSON gösterimi 
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
Alanlar
listOptions

object (ListOptions)

Belirtildiğinde bu alanın değer listesini desteklediğini gösterir. Alan yayınlandıktan sonra bu ayar değiştirilemez.
choices[]

object (Choice)

Bu seçim alanı için kullanılabilen seçenekler. Liste sırası tutarlıdır ve insertBeforeChoice ile değiştirilir.

ListOptions

İlişkili bir alan türünün çok değerli varyantı için seçenekler.

JSON gösterimi 
{
  "maxEntries": integer
}
Alanlar
maxEntries

integer

İzin verilen maksimum giriş sayısı.

Seçim

Seçim alanı tercihi.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
id

string

Seçimin benzersiz değeri. Bu kimlik otomatik olarak oluşturulur. Şu normal ifadeyle eşleşir: ([a-zA-Z0-9_])+.
properties

object (Properties)

Seçimin temel özellikleri.
lifecycle

object (Lifecycle)

Yalnızca çıkış. Seçimin yaşam döngüsü.
displayHints

object (DisplayHints)

Yalnızca çıkış. Bir seçeneği oluşturmak için kullanıcı arayüzünde ipuçları gösterilir.
schemaCapabilities

object (SchemaCapabilities)

Yalnızca çıkış. Seçeneği düzenlerken bu seçenekle ilgili özellikler.
appliedCapabilities

object (AppliedCapabilities)

Yalnızca çıkış. Uygulanan meta verilerde bu seçimle ilgili özellikler.
creator

object (UserInfo)

Yalnızca çıkış. Bu seçeneği oluşturan kullanıcı.
createTime

string (Timestamp format)

Yalnızca çıkış. Bu seçimin oluşturulma zamanı.
updater

object (UserInfo)

Yalnızca çıkış. Bu seçimi en son güncelleyen kullanıcı.
updateTime

string (Timestamp format)

Yalnızca çıkış. Bu seçimin son güncellenme zamanı.
publisher

object (UserInfo)

Yalnızca çıkış. Bu seçeneği yayınlayan kullanıcı. Bu değer, seçenek yayınlanmadığında anlam ifade etmez.
publishTime

string (Timestamp format)

Yalnızca çıkış. Bu seçimin yayınlandığı zaman. Bu değer, seçenek yayınlanmadığında anlam ifade etmez.
disabler

object (UserInfo)

Yalnızca çıkış. Bu seçeneği devre dışı bırakan kullanıcı. Bu değer, seçenek devre dışı bırakılmadığında anlam ifade etmez.
disableTime

string (Timestamp format)

Yalnızca çıkış. Bu seçeneğin devre dışı bırakıldığı zaman. Bu değer, seçim devre dışı bırakılmadığında anlam ifade etmez.
lockStatus

object (LockStatus)

Yalnızca çıkış. Bu seçimin LockStatus.

Özellikler

Seçimin temel özellikleri.

JSON gösterimi 
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
Alanlar
displayName

string

Zorunlu. Kullanıcı arayüzünde gösterilen, bu alanı tanımlayan görünen metin.
description

string

Bu etiketin açıklaması.
badgeConfig

object (BadgeConfig)

Bu seçim için rozet yapılandırması. Bu seçenek ayarlandığında, bu seçeneğe sahip etiket "rozetli etiket" olarak kabul edilir.
insertBeforeChoice

string

Yalnızca giriş. Bu seçeneği, belirtilen seçeneğin önüne ekleyin veya taşıyın. Boşsa seçim listenin sonuna yerleştirilir.

BadgeConfig

Etiketin rozet durumu.

JSON gösterimi 
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
Alanlar
color

object (Color)

Rozetin rengi. Belirtilmediğinde rozet oluşturulmaz. Burada ayarlanan arka plan, ön plan ve solo (açık ve koyu mod) renkleri, Drive kullanıcı arayüzünde en yakın önerilen desteklenen renge dönüştürülür.
priorityOverride

string (int64 format)

Bu rozetin varsayılan genel önceliğini geçersiz kılın. 0 olarak ayarlandığında varsayılan öncelik sezgisel yöntemi kullanılır.

Renk

RGBA renk alanındaki bir rengi temsil eder. Bu gösterim, çeşitli dillerdeki renk gösterimlerine dönüştürme ve bu gösterimlerden dönüştürme işleminin kolaylığı için tasarlanmıştır. Örneğin, bu gösterimin alanları Java'da java.awt.Color oluşturucusuna, iOS'te UIColor'ın +colorWithRed:green:blue:alpha yöntemine kolayca sağlanabilir ve biraz çalışmayla JavaScript'te CSS rgba() dizesi olarak kolayca biçimlendirilebilir.

Bu referans sayfasında, RGB değerini yorumlamak için kullanılması gereken mutlak renk alanı (ör. sRGB, Adobe RGB, DCI-P3 ve BT.2020) hakkında bilgi verilmemektedir. Uygulamalar varsayılan olarak sRGB renk alanını kullanmalıdır.

Renk eşitliğine karar verilmesi gerektiğinde, aksi belgelenmediği sürece uygulamalar, kırmızı, yeşil, mavi ve alfa değerlerinin her biri en fazla 1e-5 farklıysa iki rengi eşit olarak kabul eder.

Örnek (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();
 }
 // ...

Örnek (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;
}
// ...

Örnek (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('');
};

// ...
JSON gösterimi 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Alanlar
red

number

Renk içindeki kırmızı miktarının [0, 1] aralığındaki değeri.
green

number

Renk içindeki yeşil miktarı [0, 1] aralığında bir değer olarak.
blue

number

Rengin mavi bileşeninin [0, 1] aralığındaki değeri.
alpha

number

Bu rengin piksele uygulanması gereken oranı. Yani, nihai piksel rengi şu denklemle tanımlanır:

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

Bu nedenle, 1,0 değeri düz bir renge, 0,0 değeri ise tamamen şeffaf bir renge karşılık gelir. Bu, varsayılan değer ile ayarlanmamış değer arasında ayrım yapabilmek için basit bir kayan nokta skaler yerine sarmalayıcı ileti kullanır. Atlanırsa bu renk nesnesi düz renk olarak oluşturulur (alfa değerine açıkça 1, 0 değeri verilmiş gibi).

DisplayHints

Bir seçeneği oluşturmak için kullanıcı arayüzü ipuçlarını gösterin.

JSON gösterimi 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "badgeColors": {
    object (BadgeColors)
  },
  "darkBadgeColors": {
    object (BadgeColors)
  },
  "badgePriority": string
}
Alanlar
disabled

boolean

Seçeneğin kullanıcı arayüzünde devre dışı olarak gösterilip gösterilmeyeceği.
shownInApply

boolean

Bu seçenek, değerler bir Drive öğesine uygulanırken uygulama menüsünde gösterilmelidir.
badgeColors

object (BadgeColors)

Rozet için kullanılacak renkler. Seçilen properties.badge_config.color'ya göre Google Materyal renklerine değiştirildi.
darkBadgeColors

object (BadgeColors)

Rozet için kullanılacak koyu mod rengi. Seçilen properties.badge_config.color'ya göre Google Materyal renklerine değiştirildi.
badgePriority

string (int64 format)

Bu rozetin önceliği. Birden fazla rozeti karşılaştırmak ve sıralamak için kullanılır. Daha düşük bir sayı, rozetin önce gösterilmesi gerektiği anlamına gelir. Rozet yapılandırması yoksa bu değer 0 olur. Aksi takdirde, bu değer BadgeConfig.priority_override olarak veya etiketin oluşturulma tarihini, alan ve seçenek önceliğini tercih eden varsayılan sezgisel yöntem olarak ayarlanır.

BadgeColors

BadgeConfig'ten türetilen ve önerilen en yakın desteklenen renge değiştirilen renk.

JSON gösterimi 
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
Alanlar
backgroundColor

object (Color)

Yalnızca çıkış. Ön planla eşleşen rozet arka planı.
foregroundColor

object (Color)

Yalnızca çıkış. Arka planla eşleşen rozet ön planı.
soloColor

object (Color)

Yalnızca çıkış. Arka planı olmayan metin için kullanılabilecek renk.

SchemaCapabilities

Seçimi düzenlerken bu seçimle ilgili özellikler.

JSON gösterimi 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Alanlar
canUpdate

boolean

Kullanıcının bu seçimi güncelleyip güncelleyemeyeceği.
canDelete

boolean

Kullanıcının bu seçimi silip silemeyeceği.
canDisable

boolean

Kullanıcının bu seçimi devre dışı bırakıp bırakamayacağı.
canEnable

boolean

Kullanıcının bu seçeneği etkinleştirip etkinleştiremeyeceği.

AppliedCapabilities

Uygulanan meta verilerde bu seçimle ilgili özellikler.

JSON gösterimi 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
Alanlar
canRead

boolean

Kullanıcının öğelerdeki ilgili uygulanan meta verileri okuyup okuyamayacağı.
canSelect

boolean

Kullanıcının bir öğede bu seçimi yapıp yapamayacağı.

LockStatus

Bir etiket bileşeninin kilitli olarak kabul edilip edilmeyeceğiyle ilgili bilgileri içerir.

JSON gösterimi 
{
  "locked": boolean
}
Alanlar
locked

boolean

Yalnızca çıkış. Bu etiket bileşeninin bir etiket kilidinin (doğrudan) hedefi olup olmadığını gösterir. Bir etiket bileşeni, doğrudan etiket kilidinin hedefi olmasa bile örtülü olarak kilitlenebilir. Bu durumda bu alan yanlış olarak ayarlanır.

UserOptions

Kullanıcı alanı türü seçenekleri.

JSON gösterimi 
{
  "listOptions": {
    object (ListOptions)
  }
}
Alanlar
listOptions

object (ListOptions)

Belirtildiğinde, bu alanın bir değer listesini desteklediğini gösterir. Alan yayınlandıktan sonra bu ayar değiştirilemez.

Özellikler

Alanın temel özellikleri.

JSON gösterimi 
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
Alanlar
displayName

string

Zorunlu. Kullanıcı arayüzünde gösterilen, bu alanı tanımlayan görünen metin.
required

boolean

Alan zorunlu olarak işaretlenmeli mi?
insertBeforeField

string

Yalnızca giriş. Bu alanı belirtilen alandan önce ekleyin veya taşıyın. Boşsa alan listenin sonuna yerleştirilir.

DisplayHints

Bir alanı oluşturmak için kullanıcı arayüzü görüntüleme ipuçları.

JSON gösterimi 
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
Alanlar
required

boolean

Alan kullanıcı arayüzünde zorunlu olarak gösterilmelidir.
disabled

boolean

Alan kullanıcı arayüzünde devre dışı olarak gösterilmeli mi?
shownInApply

boolean

Bu alan, değerler bir Drive öğesine uygulanırken uygulama menüsünde gösterilmelidir.

SchemaCapabilities

Alan düzenlenirken bu alanla ilgili özellikler.

JSON gösterimi 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Alanlar
canUpdate

boolean

Kullanıcının bu alanı değiştirip değiştiremeyeceği.
canDelete

boolean

Kullanıcının bu alanı silip silemeyeceği. Kullanıcının izni olmalı ve alan kullanımdan kaldırılmış olmalıdır.
canDisable

boolean

Kullanıcının bu alanı devre dışı bırakıp bırakamayacağı. Kullanıcının izni olmalı ve bu alan devre dışı bırakılmamış olmalıdır.
canEnable

boolean

Kullanıcının bu alanı etkinleştirip etkinleştiremeyeceği. Kullanıcının izni olmalı ve bu alan devre dışı bırakılmalıdır.

AppliedCapabilities

Uygulanan meta verilerdeki bu alanla ilgili özellikler.

JSON gösterimi 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
Alanlar
canRead

boolean

Kullanıcının öğelerdeki ilgili uygulanan meta verileri okuyup okuyamayacağı.
canWrite

boolean

Kullanıcının bu alanı Drive öğelerinde ayarlayıp ayarlayamayacağı.

EnabledAppSettings

Etiketin kullanılabileceği Google Workspace uygulamalarını açıklar.

JSON gösterimi 
{
  "enabledApps": [
    {
      object (EnabledApp)
    }
  ]
}
Alanlar
enabledApps[]

object (EnabledApp)

İsteğe bağlı. Etiketin kullanılabileceği uygulamaların listesi.

EnabledApp

Etiketin kullanılabileceği bir uygulama.

JSON gösterimi 
{
  "app": enum (App)
}
Alanlar
app

enum (App)

İsteğe bağlı. Uygulamanın adı.

Uygulama

Etiketlerin kullanılabileceği olası Google Workspace uygulamaları grubu.

Sıralamalar
APP_UNSPECIFIED Belirtilmedi
DRIVE Drive
GMAIL Gmail

Yöntemler

create

 Etiket oluşturur.

delete

 Bir etiketi ve Drive öğelerindeki ilgili meta verileri kalıcı olarak siler.

delta

 Yeni bir taslak düzeltme ile sonuçlanan bir dizi güncelleme isteği uygulayarak tek bir etiketi günceller.

disable

 Yayınlanmış bir etiketi devre dışı bırakma

enable

 Devre dışı bırakılmış bir etiketi etkinleştirip yayınlanmış durumuna geri yükleyin.

get

 Kaynak adına göre etiket alma.

list

 Etiketleri listeleyin.

publish

 Etiketteki tüm taslak değişiklikleri yayınlayın.

updateLabelCopyMode

 Bir etiketin CopyMode özelliğini günceller.

updateLabelEnabledAppSettings

 Bir etiketin EnabledAppSettings özelliğini günceller.

updatePermissions

 Bir etiketin izinlerini günceller.