REST Resource: labels

Kaynak: Etiket

Etiketler, öğeleri organize etmek ve aramak için Drive öğelerine uygulanabilecek bir sınıflandırma tanımlar. Etiketler basit dizelerden oluşabilir veya Drive öğelerini düzenlemek ve aramak için kullanılabilecek ek meta verileri tanımlayan 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çimindedir. Aşağıdaki id ve revisionId hükümlerini inceleyin.
id

string

Yalnızca çıkış. Bu etiketin dünya genelinde benzersiz tanımlayıcısıdır. Kimlik, name etiketinin bir parçasıdır ancak name'ten farklı olarak 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 düzeltilen özellikleri değiştiğinde yeni bir düzeltme 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şturulduğu 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ış. Yayınlanıp yayınlanmadığı, desteği sonlandırılıp sonlandırılmadığı ve taslak değişiklikleri olup olmadığı da dahil olmak üzere etiketin yaşam döngüsü durumu.
displayHints

object (DisplayHints)

Yalnızca çıkış. Kullanıcı arayüzünde, etiketi oluşturmayla ilgili ipuçları gösterilir.
appliedCapabilities

object (AppliedCapabilities)

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

object (SchemaCapabilities)

Yalnızca çıkış. Kullanıcının bu etikette sahip olduğu özellikler.
appliedLabelPolicy

object (AppliedLabelPolicy)

Yalnızca çıkış. Drive öğelerine uygulandığında bu etiketin davranışı.
fields[]

object (Field)

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

string

Kullanıcılara bu etiket ve nasıl kullanılması gerektiği hakkında daha fazla bilgi edinmelerini sağlamak için gösterilecek özel URL.
lockStatus

object (LockStatus)

Yalnızca çıkış. Bu etiketin LockStatus değeri.
enabledAppSettings

object (EnabledAppSettings)

İsteğe bağlı. Bu etiket için EnabledAppSettings.

LabelType

Bu etiketin türü.

Sıralamalar
LABEL_TYPE_UNSPECIFIED Bilinmeyen etiket türü.
SHARED Ortak 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 bir etiket. Bu etiketler salt okunurdur.

UserInfo

Kullanıcı hakkında bilgiler.

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

string

Daha fazla bilgi edinmek için People API ile kullanılabilen bu kullanıcının tanımlayıcısıdır. Örneğin, kişiler/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çim gibi bir nesnenin yaşam döngüsü durumu. Yaşam döngüsü aşağıdaki geçişleri zorunlu kılar:

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

Yayınlanan ve devre dışı bırakılan durumların bazı ayırt edici özellikleri vardır:

  • Yayınlandı: Bu durumdaki bir nesnede bazı değişiklikler yapılabilir. Bu durumda hasUnpublishedChanges doğru olur. Ayrıca, bazı değişikliklere izin verilmez. Genellikle, etiketle ilgili mevcut meta verileri geçersiz kılacak veya yeni kısıtlamalara neden olacak değişiklikler reddedilir.
  • Devre dışı: Devre dışı bırakıldığında, yapılandırılmış 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ü ile ilişkili nesnenin durumu.
hasUnpublishedChanges

boolean

Yalnızca çıkış. Bu yaşam döngüsü ile ilişkili nesnenin yayınlanmamış değişiklikleri 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ü ile ilişkili nesnenin durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmeyen durum.
UNPUBLISHED_DRAFT Bir nesnenin ilk durumu. Nesne yayınlandıktan sonra hiçbir zaman bu duruma geri dönemez. Bir nesne yayınlandıktan sonra belirli türde 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ı ve o zamandan beri devre dışı bırakıldı. Nesnede, hasUnpublishedChanges ile belirtildiği gibi yayınlanmamış taslak değişiklikler olabilir.
DELETED Nesne silindi.

DisabledPolicy

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

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

boolean

Devre dışı bırakılmış bu nesnenin Drive öğelerindeki uygula 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

Kullanıcı arayüzünde, etiketi oluşturmayla ilgili ipuçları gösterilir.

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, bir Drive öğesine değer uygulanırken uygulama menüsünde gösterilir.
priority

string (int64 format)

Etiketin listede gösterilme sırası.

AppliedCapabilities

Kullanıcının bu etiketin uygulanmış 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 uygulanmış meta verileri okuyup okuyamayacağını belirtir.
canApply

boolean

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

boolean

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

SchemaCapabilities

Etiket düzenlenirken 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 izne sahip olması ve etiketin devre dışı bırakılmış olması gerekir.
canDisable

boolean

Kullanıcının bu etiketi devre dışı bırakıp bırakamayacağını belirtir. Kullanıcının izni olması ve bu etiketin devre dışı bırakılmamış olması gerekir.
canEnable

boolean

Kullanıcının bu etiketi etkinleştirip etkinleştiremeyeceği. Kullanıcının izni olması ve bu etiketin devre dışı bırakılmış olması gerekir.

AppliedLabelPolicy

Drive öğelerine uygulandığında bu etiketin davranışı.

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

enum (CopyMode)

Bir Drive öğesi kopyalanırken uygulanan etiketin ve alan değerlerinin nasıl kopyalanması gerektiğini belirtir.

CopyMode

Bir Drive öğesi kopyalanırken uygulanan etiketin ve alan değerlerinin nasıl kopyalanması gerektiğini belirtir.

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 Etiket, kopyayı oluşturan kullanıcı tarafından uygulanabiliyorsa uygulanan etiket ve alan değerleri 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 dosyaları 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ış. Kullanıcı arayüzünde, bir alanın oluşturulmasıyla ilgili ipuçları gösterilir.
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 alanda sahip olduğu özellikler ve etiket Drive öğelerine uygulandığında alan 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şturulduğu 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ışı değilse 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ışı değilse bu değerin bir anlamı yoktur.
lockStatus

object (LockStatus)

Yalnızca çıkış. Bu alanın LockStatus değeri.
Birlik alanı type. Bu alanın veri türü ve seçenekleri. Veri türü yayınlandıktan sonra 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ı için geçerli minimum değer uzunluğu.
maxLength

integer

Yalnızca çıkış. Metin alanı için geçerli maksimum değer 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 minimum geçerli 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ış. Minimum geçerli değer (yıl, ay, gün).
maxValue

object (Date)

Yalnızca çıkış. Geçerli maksimum 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 (ay/gün/yıl)

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • Sıfır gün içeren bir yıl ve ay (ör. 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 veya yıl olmadan tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan 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. 0 değerini kullanarak ise yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.

SelectionOptions

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

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

object (ListOptions)

Belirtilen durumlarda, bu alanın bir değer listesi desteklediğini gösterir. Alan yayınlandıktan sonra bu ayar değiştirilemez.
choices[]

object (Choice)

Bu seçim alanında kullanılabilen seçenekler. Liste sırası tutarlı ve insertBeforeChoice ile değiştirilmiş.

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çeneğin benzersiz değeri. Bu kimlik otomatik olarak oluşturulur. Şu normal ifadeyle eşleşir: ([a-zA-Z0-9_])+.
properties

object (Properties)

Seçeneğin temel özellikleri.
lifecycle

object (Lifecycle)

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

object (DisplayHints)

Yalnızca çıkış. Kullanıcı arayüzünde, bir seçimin oluşturulmasıyla ilgili ipuçları gösterilir.
schemaCapabilities

object (SchemaCapabilities)

Yalnızca çıkış. Seçenek düzenlenirken 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çimi oluşturan kullanıcı.
createTime

string (Timestamp format)

Yalnızca çıkış. Bu seçimin oluşturulduğu 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çimi yayınlayan kullanıcı. Seçim yayınlanmadığında bu değerin bir anlamı yoktur.
publishTime

string (Timestamp format)

Yalnızca çıkış. Bu seçimin yayınlandığı zaman. Seçim yayınlanmadığında bu değerin bir anlamı yoktur.
disabler

object (UserInfo)

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

string (Timestamp format)

Yalnızca çıkış. Bu seçimin devre dışı bırakıldığı zaman. Seçenek devre dışı bırakılmadığında bu değerin bir anlamı yoktur.
lockStatus

object (LockStatus)

Yalnızca çıkış. Bu seçimin LockStatus değeri.

Özellikler

Seçeneğin 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üntüleme metni.
description

string

Bu etiketin açıklaması.
badgeConfig

object (BadgeConfig)

Bu seçimin rozet yapılandırması. Bu ayar etkinleştirildiğinde, bu seçimin sahibi olan etiket "rozetli etiket" olarak kabul edilir.
insertBeforeChoice

string

Yalnızca giriş. Bu seçimi belirtilen seçimin ö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. Belirtilmemişse rozet oluşturulmaz. Burada ayarlanan arka plan, ön plan ve tek renk (açık ve koyu mod) renkleri, Drive kullanıcı arayüzünde önerilen en yakın desteklenen renge değiştirilir.
priorityOverride

string (int64 format)

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

Renk

RGBA renk alanındaki bir rengi temsil eder. Bu gösterim, çeşitli dillerdeki renk gösterimlerine ve bu gösterimlerden dönüşümün basitliği için tasarlanmıştır. Örneğin, bu temsilin alanları Java'da java.awt.Color sınıfının kurucusuna kolayca sağlanabilir; iOS'te UIColor'ın +colorWithRed:green:blue:alpha yöntemine de 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 yoktur. Varsayılan olarak uygulamalar sRGB renk alanını kullanmalıdır.

Renk eşitliğine karar verilmesi gerektiğinde, aksi belirtilmediğ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 değerlendirir.

Ö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

[0, 1] aralığındaki bir değer olarak renkteki kırmızı miktarı.
green

number

[0, 1] aralığındaki bir değer olarak renkteki yeşil miktarı.
blue

number

[0, 1] aralığındaki bir değer olarak renkteki mavi miktarı.
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, 1,0 değerinin düz bir renge, 0,0 değerinin ise tamamen şeffaf bir renge karşılık geldiği anlamına gelir. Varsayılan değer ile ayarlanmamış değer arasında ayrım yapılabilmesi için bu işlemde basit bir kayan nokta skaler yerine sarmalayıcı mesaj kullanılı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

Kullanıcı arayüzünde, bir seçeneğin oluşturulmasıyla ilgili ipuçları gösterilir.

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, bir Drive öğesine değer uygulanırken uygulama menüsünde gösterilir.
badgeColors

object (BadgeColors)

Rozet için kullanılacak renkler. Seçilen properties.badge_config.color'e 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'e 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. 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 veya etiketin oluşturulma tarihini, alan ve seçenek önceliğini tercih eden varsayılan sezgisel yönteme ayarlanır.

BadgeColors

BadgeConfig'den 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 metinler için kullanılabilecek renk.

SchemaCapabilities

Seçim düzenlenirken 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ğını belirtir.
canEnable

boolean

Kullanıcının bu seçimi 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 uygulanmış meta verileri okuyup okuyamayacağını belirtir.
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 LabelLock'un (doğrudan) hedefi olup olmadığını belirtir. Bir etiket bileşeni, LabelLock'un doğrudan hedefi olmasa bile dolaylı 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)

Belirtilen durumlarda, bu alanın bir değer listesi 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üntüleme metni.
required

boolean

Alanın zorunlu olarak işaretlenip işaretlenmeyeceği.
insertBeforeField

string

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

DisplayHints

Kullanıcı arayüzünde, bir alanın oluşturulmasıyla ilgili ipuçları gösterilir.

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

boolean

Alanın kullanıcı arayüzünde zorunlu olarak gösterilip gösterilmeyeceği.
disabled

boolean

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

boolean

Bu alan, bir Drive öğesine değer 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 izinleri olmalı ve alanın desteği sonlandırılmış olmalıdır.
canDisable

boolean

Kullanıcının bu alanı devre dışı bırakıp bırakamayacağını belirtir. Kullanıcının izni olması ve bu alanın devre dışı bırakılmaması gerekir.
canEnable

boolean

Kullanıcının bu alanı etkinleştirip etkinleştiremeyeceği. Kullanıcının izni olması ve bu alanın devre dışı bırakılması gerekir.

AppliedCapabilities

Uygulanan meta verilerde bu alanla ilgili özellikler.

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

boolean

Kullanıcının öğelerdeki ilgili uygulanmış meta verileri okuyup okuyamayacağını belirtir.
canWrite

boolean

Kullanıcının Drive öğelerinde bu alanı ayarlayabilmesi.

EnabledAppSettings

Etiketin kullanılabileceği 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ı Workspace uygulamaları grubu.

Sıralamalar
APP_UNSPECIFIED Belirtilmedi
DRIVE Drive'a gidin.
GMAIL Gmail

Yöntemler

create

 Yeni bir etiket oluşturur.

delete

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

delta

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

disable

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

enable

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

get

 Bir etiketi kaynak adına göre alın.

list

 Etiket listesini görüntüleyin.

publish

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

updateLabelCopyMode

 Etiketin CopyMode değerini günceller.

updateLabelEnabledAppSettings

 Bir etiketin EabledAppSettings özelliğini günceller.

updatePermissions

 Etiketin izinlerini günceller.