REST Resource: labels

Resource: Label

Label menentukan taksonomi yang dapat diterapkan ke item Drive untuk mengatur dan menelusuri item. Label dapat berupa string sederhana, atau dapat berisi kolom yang menjelaskan metadata tambahan yang dapat digunakan lebih lanjut untuk mengatur dan menelusuri item Drive.

Representasi 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)
  },
  "enabledAppSettings": {
    object (EnabledAppSettings)
  }
}
Kolom
name

string

Hanya output. Nama resource label. Akan dalam bentuk: labels/{id} atau labels/{id}@{revisionId}, bergantung pada permintaan. Lihat id dan revisionId di bawah.
id

string

Hanya output. ID unik global untuk label ini. ID merupakan bagian dari label name, tetapi tidak seperti name, ID konsisten di antara revisi. Cocok dengan regex: ([a-zA-Z0-9])+.
revisionId

string

Hanya output. ID revisi label. ID revisi mungkin menjadi bagian dari label name, bergantung pada permintaan yang dikeluarkan. Revisi baru dibuat setiap kali properti berversi dari label diubah. Cocok dengan regex: ([a-zA-Z0-9])+.
labelType

enum (LabelType)

Wajib. Jenis label.
creator

object (UserInfo)

Hanya output. Pengguna yang membuat label ini.
createTime

string (Timestamp format)

Hanya output. Waktu saat label ini dibuat.
revisionCreator

object (UserInfo)

Hanya output. Pengguna yang membuat revisi label ini.
revisionCreateTime

string (Timestamp format)

Hanya output. Waktu saat revisi label ini dibuat.
publisher

object (UserInfo)

Hanya output. Pengguna yang memublikasikan label ini. Nilai ini tidak memiliki arti jika label tidak dipublikasikan.
publishTime

string (Timestamp format)

Hanya output. Waktu label ini dipublikasikan. Nilai ini tidak memiliki arti jika label tidak dipublikasikan.
disabler

object (UserInfo)

Hanya output. Pengguna yang menonaktifkan label ini. Nilai ini tidak memiliki arti jika label tidak dinonaktifkan.
disableTime

string (Timestamp format)

Hanya output. Waktu label ini dinonaktifkan. Nilai ini tidak memiliki arti jika label tidak dinonaktifkan.
customer

string

Hanya output. Pelanggan yang memiliki label ini. Misalnya: customers/123abc789.
properties

object (Properties)

Wajib. Properti dasar label.
lifecycle

object (Lifecycle)

Hanya output. Status siklus proses label, termasuk apakah label dipublikasikan, tidak digunakan lagi, dan memiliki perubahan draf.
displayHints

object (DisplayHints)

Hanya output. Petunjuk tampilan UI untuk merender label.
appliedCapabilities

object (AppliedCapabilities)

Hanya output. Kemampuan yang terkait dengan label ini pada metadata yang diterapkan.
schemaCapabilities

object (SchemaCapabilities)

Hanya output. Kemampuan yang dimiliki pengguna pada label ini.
appliedLabelPolicy

object (AppliedLabelPolicy)

Hanya output. Perilaku label ini saat diterapkan ke item Drive.
fields[]

object (Field)

Daftar kolom dalam urutan prioritas menurun.
learnMoreUri

string

URL kustom yang ditampilkan kepada pengguna agar mereka dapat mempelajari lebih lanjut label ini dan cara penggunaannya.
lockStatus

object (LockStatus)

Hanya output. LockStatus label ini.
enabledAppSettings

object (EnabledAppSettings)

Opsional. EnabledAppSettings untuk Label ini.

LabelType

Jenis label ini.

Enum
LABEL_TYPE_UNSPECIFIED Jenis label tidak diketahui.
SHARED Label bersama dapat dibagikan kepada pengguna untuk diterapkan ke item Drive.
ADMIN Label milik admin. Hanya dapat dibuat dan diedit oleh admin. Mendukung beberapa fitur tambahan khusus admin.
GOOGLE_APP Label yang dimiliki oleh aplikasi Google internal, bukan pelanggan. Label ini bersifat hanya baca.

UserInfo

Informasi tentang pengguna.

Representasi JSON 
{
  "person": string
}
Kolom
person

string

ID untuk pengguna ini yang dapat digunakan dengan People API untuk mendapatkan informasi selengkapnya. Misalnya, people/12345678.

Properti

Properti dasar label.

Representasi JSON 
{
  "title": string,
  "description": string
}
Kolom
title

string

Wajib. Judul label.
description

string

Deskripsi label.

Lifecycle

Status siklus proses objek, seperti label, kolom, atau pilihan. Untuk mengetahui informasi selengkapnya, lihat Siklus proses label.

Siklus proses ini menerapkan transisi berikut:

  • UNPUBLISHED_DRAFT (status awal)
  • UNPUBLISHED_DRAFT -> PUBLISHED
  • UNPUBLISHED_DRAFT -> (Dihapus)
  • PUBLISHED -> DISABLED
  • DISABLED -> PUBLISHED
  • DISABLED -> (Dihapus)

Status dipublikasikan dan dinonaktifkan memiliki beberapa karakteristik yang berbeda:

  • Published: Beberapa jenis perubahan dapat dilakukan pada objek dalam status ini, dan dalam hal ini hasUnpublishedChanges akan bernilai benar (true). Selain itu, beberapa jenis perubahan tidak diizinkan. Secara umum, setiap perubahan yang akan membatalkan atau menyebabkan batasan baru pada metadata yang ada terkait dengan label akan ditolak.
  • Disabled: Jika dinonaktifkan, DisabledPolicy yang dikonfigurasi akan berlaku.
Representasi JSON 
{
  "state": enum (State),
  "hasUnpublishedChanges": boolean,
  "disabledPolicy": {
    object (DisabledPolicy)
  }
}
Kolom
state

enum (State)

Hanya output. Status objek yang terkait dengan siklus proses ini.
hasUnpublishedChanges

boolean

Hanya output. Apakah objek yang terkait dengan siklus proses ini memiliki perubahan yang belum dipublikasikan.
disabledPolicy

object (DisabledPolicy)

Kebijakan yang mengatur cara menampilkan label, kolom, atau pilihan yang dinonaktifkan.

Negara Bagian

Status objek yang terkait dengan siklus proses ini.

Enum
STATE_UNSPECIFIED Status Tidak Diketahui.
UNPUBLISHED_DRAFT Status awal objek. Setelah dipublikasikan, objek tidak akan pernah kembali ke status ini. Setelah objek dipublikasikan, jenis perubahan tertentu tidak lagi diizinkan.
PUBLISHED Objek telah dipublikasikan. Objek mungkin memiliki perubahan draf yang belum dipublikasikan seperti yang ditunjukkan oleh hasUnpublishedChanges.
DISABLED Objek telah dipublikasikan dan kemudian dinonaktifkan. Objek mungkin memiliki perubahan draf yang belum dipublikasikan seperti yang ditunjukkan oleh hasUnpublishedChanges.
DELETED Objek telah dihapus.

DisabledPolicy

Kebijakan yang mengatur cara memperlakukan label, kolom, atau pilihan yang dinonaktifkan dalam konteks yang berbeda.

Representasi JSON 
{
  "hideInSearch": boolean,
  "showInApply": boolean
}
Kolom
showInApply

boolean

Menentukan apakah akan menampilkan objek yang dinonaktifkan ini di menu terapkan pada item Drive.

  • Jika true, objek umumnya ditampilkan di UI sebagai dinonaktifkan dan tidak dapat dipilih.
  • Saat false, objek umumnya disembunyikan di UI.

DisplayHints

Petunjuk tampilan UI untuk merender label.

Representasi JSON 
{
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean,
  "priority": string
}
Kolom
disabled

boolean

Apakah label harus ditampilkan di UI sebagai nonaktif.
shownInApply

boolean

Label ini harus ditampilkan di menu terapkan saat menerapkan nilai ke item Drive.
priority

string (int64 format)

Urutan untuk menampilkan label dalam daftar.

AppliedCapabilities

Kemampuan yang dimiliki pengguna pada metadata yang diterapkan label ini.

Representasi JSON 
{
  "canRead": boolean,
  "canApply": boolean,
  "canRemove": boolean
}
Kolom
canRead

boolean

Apakah pengguna dapat membaca metadata yang diterapkan terkait label ini.
canApply

boolean

Apakah pengguna dapat menerapkan label ini ke item.
canRemove

boolean

Apakah pengguna dapat menghapus label ini dari item.

SchemaCapabilities

Kemampuan yang terkait dengan label ini saat mengedit label.

Representasi JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Kolom
canUpdate

boolean

Apakah pengguna dapat mengubah label ini.
canDelete

boolean

Apakah pengguna dapat menghapus label ini. Pengguna harus memiliki izin dan label harus dinonaktifkan.
canDisable

boolean

Apakah pengguna dapat menonaktifkan label ini. Pengguna harus memiliki izin dan label ini tidak boleh dinonaktifkan.
canEnable

boolean

Apakah pengguna dapat mengaktifkan label ini. Pengguna harus memiliki izin dan label ini harus dinonaktifkan.

AppliedLabelPolicy

Perilaku label ini saat diterapkan ke item Drive.

Representasi JSON 
{
  "copyMode": enum (CopyMode)
}
Kolom
copyMode

enum (CopyMode)

Menunjukkan cara label dan nilai kolom yang diterapkan harus disalin saat item Drive disalin.

CopyMode

Menunjukkan cara label dan nilai kolom yang diterapkan harus disalin saat item Drive disalin.

Enum
COPY_MODE_UNSPECIFIED Mode salin tidak ditentukan.
DO_NOT_COPY Label dan nilai kolom yang diterapkan tidak disalin secara default saat item Drive yang diterapkan label tersebut disalin.
ALWAYS_COPY Nilai kolom dan label yang diterapkan selalu disalin saat item Drive yang diterapkan label tersebut disalin. Hanya admin yang dapat menggunakan mode ini.
COPY_APPLIABLE Label dan nilai kolom yang diterapkan akan disalin jika label dapat diterapkan oleh pengguna yang membuat salinan.

Kolom

Menentukan kolom yang memiliki nama tampilan, jenis data, dan opsi konfigurasi lainnya. Kolom ini menentukan jenis metadata yang dapat ditetapkan pada item Drive.

Representasi 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.
}
Kolom
id

string

Hanya output. Kunci kolom, unik dalam label atau library.

Nilai ini dibuat secara otomatis. Cocok dengan regex: ([a-zA-Z0-9])+.
queryKey

string

Hanya output. Kunci yang akan digunakan saat membuat kueri penelusuran Drive untuk menemukan file berdasarkan nilai yang ditentukan untuk kolom ini pada file. Misalnya, "{queryKey} > 01-01-2001".
properties

object (Properties)

Properti dasar kolom.
lifecycle

object (Lifecycle)

Hanya output. Siklus proses kolom ini.
displayHints

object (DisplayHints)

Hanya output. Petunjuk tampilan UI untuk merender kolom.
schemaCapabilities

object (SchemaCapabilities)

Hanya output. Kemampuan yang dimiliki pengguna ini saat mengedit kolom ini.
appliedCapabilities

object (AppliedCapabilities)

Hanya output. Kemampuan yang dimiliki pengguna ini pada kolom ini dan nilainya saat label diterapkan pada item Drive.
creator

object (UserInfo)

Hanya output. Pengguna yang membuat kolom ini.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan kolom ini.
updater

object (UserInfo)

Hanya output. Pengguna yang mengubah kolom ini.
updateTime

string (Timestamp format)

Hanya output. Waktu kolom ini diperbarui.
publisher

object (UserInfo)

Hanya output. Pengguna yang memublikasikan kolom ini. Nilai ini tidak memiliki arti jika kolom tidak dipublikasikan.
disabler

object (UserInfo)

Hanya output. Pengguna yang menonaktifkan kolom ini. Nilai ini tidak memiliki arti jika kolom tidak dinonaktifkan.
disableTime

string (Timestamp format)

Hanya output. Waktu kolom ini dinonaktifkan. Nilai ini tidak memiliki arti jika kolom tidak dinonaktifkan.
lockStatus

object (LockStatus)

Hanya output. LockStatus kolom ini.
Kolom union type. Jenis data dan opsi kolom ini. Setelah dipublikasikan, jenis data tidak dapat diubah. type hanya dapat berupa salah satu dari berikut:
textOptions

object (TextOptions)

Opsi kolom teks.
integerOptions

object (IntegerOptions)

Opsi kolom bilangan bulat.
dateOptions

object (DateOptions)

Opsi kolom tanggal.
selectionOptions

object (SelectionOptions)

Opsi kolom pilihan.
userOptions

object (UserOptions)

Opsi kolom pengguna.

TextOptions

Opsi untuk jenis kolom Teks.

Representasi JSON 
{
  "minLength": integer,
  "maxLength": integer
}
Kolom
minLength

integer

Hanya output. Panjang nilai valid minimum untuk kolom teks.
maxLength

integer

Hanya output. Panjang nilai valid maksimum untuk kolom teks.

IntegerOptions

Opsi untuk jenis kolom Bilangan Bulat.

Representasi JSON 
{
  "minValue": string,
  "maxValue": string
}
Kolom
minValue

string (int64 format)

Hanya output. Nilai valid minimum untuk kolom bilangan bulat.
maxValue

string (int64 format)

Hanya output. Nilai valid maksimum untuk kolom bilangan bulat.

DateOptions

Opsi untuk jenis kolom tanggal.

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

enum (DateFormat)

Opsi pemformatan tanggal yang dilokalkan. Nilai kolom ditampilkan dalam format ini sesuai dengan lokalitasnya.
dateFormat

string

Hanya output. Format tanggal ICU.
minValue

object (Date)

Hanya output. Nilai valid minimum (tahun, bulan, hari).
maxValue

object (Date)

Hanya output. Nilai valid maksimum (tahun, bulan, hari).

DateFormat

Opsi format tanggal yang dilokalkan.

Enum
DATE_FORMAT_UNSPECIFIED Format tanggal tidak ditentukan.
LONG_DATE Mencakup nama bulan lengkap. Misalnya, 12 Januari 1999 (MMMM d, y)
SHORT_DATE Representasi numerik singkat. Misalnya, 12/13/99 (B/h/yy)

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

SelectionOptions

Opsi untuk jenis kolom pilihan.

Representasi JSON 
{
  "listOptions": {
    object (ListOptions)
  },
  "choices": [
    {
      object (Choice)
    }
  ]
}
Kolom
listOptions

object (ListOptions)

Jika ditentukan, menunjukkan bahwa kolom ini mendukung daftar nilai. Setelah kolom dipublikasikan, kolom ini tidak dapat diubah.
choices[]

object (Choice)

Opsi yang tersedia untuk kolom pilihan ini. Urutan daftar konsisten, dan diubah dengan insertBeforeChoice.

ListOptions

Opsi untuk varian multinilai dari jenis kolom terkait.

Representasi JSON 
{
  "maxEntries": integer
}
Kolom
maxEntries

integer

Jumlah maksimum entri yang diizinkan.

Pilihan

Pilihan kolom pilihan.

Representasi 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)
  }
}
Kolom
id

string

Nilai unik pilihan. ID ini dibuat secara otomatis. Cocok dengan regex: ([a-zA-Z0-9_])+.
properties

object (Properties)

Properti dasar pilihan.
lifecycle

object (Lifecycle)

Hanya output. Siklus proses pilihan.
displayHints

object (DisplayHints)

Hanya output. Petunjuk tampilan UI untuk merender pilihan.
schemaCapabilities

object (SchemaCapabilities)

Hanya output. Kemampuan yang terkait dengan opsi ini saat mengedit opsi.
appliedCapabilities

object (AppliedCapabilities)

Hanya output. Kemampuan yang terkait dengan pilihan ini pada metadata yang diterapkan.
creator

object (UserInfo)

Hanya output. Pengguna yang membuat pilihan ini.
createTime

string (Timestamp format)

Hanya output. Waktu saat pilihan ini dibuat.
updater

object (UserInfo)

Hanya output. Pengguna yang terakhir memperbarui pilihan ini.
updateTime

string (Timestamp format)

Hanya output. Waktu terakhir pilihan ini diperbarui.
publisher

object (UserInfo)

Hanya output. Pengguna yang memublikasikan pilihan ini. Nilai ini tidak memiliki arti jika pilihan tidak dipublikasikan.
publishTime

string (Timestamp format)

Hanya output. Waktu pilihan ini dipublikasikan. Nilai ini tidak memiliki arti jika pilihan tidak dipublikasikan.
disabler

object (UserInfo)

Hanya output. Pengguna yang menonaktifkan pilihan ini. Nilai ini tidak memiliki arti jika opsi tidak dinonaktifkan.
disableTime

string (Timestamp format)

Hanya output. Waktu opsi ini dinonaktifkan. Nilai ini tidak memiliki arti jika pilihan tidak dinonaktifkan.
lockStatus

object (LockStatus)

Hanya output. LockStatus dari pilihan ini.

Properti

Properti dasar pilihan.

Representasi JSON 
{
  "displayName": string,
  "description": string,
  "badgeConfig": {
    object (BadgeConfig)
  },
  "insertBeforeChoice": string
}
Kolom
displayName

string

Wajib. Teks tampilan yang akan ditampilkan di UI yang mengidentifikasi kolom ini.
description

string

Deskripsi label ini.
badgeConfig

object (BadgeConfig)

Konfigurasi badge untuk pilihan ini. Jika ditetapkan, label yang memiliki pilihan ini dianggap sebagai "label berbadge".
insertBeforeChoice

string

Hanya input. Sisipkan atau pindahkan pilihan ini sebelum pilihan yang ditunjukkan. Jika kosong, pilihan ditempatkan di akhir daftar.

BadgeConfig

Status badge label.

Representasi JSON 
{
  "color": {
    object (Color)
  },
  "priorityOverride": string
}
Kolom
color

object (Color)

Warna badge. Jika tidak ditentukan, badge tidak akan dirender. Warna latar belakang, latar depan, dan solo (mode terang dan gelap) yang ditetapkan di sini diubah di UI Drive menjadi warna yang didukung dan direkomendasikan terdekat.
priorityOverride

string (int64 format)

Ganti prioritas global default badge ini. Jika disetel ke 0, heuristik prioritas default akan digunakan.

Warna

Mewakili warna dalam ruang warna RGBA. Representasi ini dirancang untuk kesederhanaan konversi ke dan dari representasi warna dalam berbagai bahasa dibandingkan dengan kepadatan. Misalnya, kolom representasi ini dapat diberikan secara sepele ke konstruktor java.awt.Color di Java; kolom ini juga dapat diberikan secara sepele ke metode +colorWithRed:green:blue:alpha UIColor di iOS; dan, dengan sedikit upaya, kolom ini dapat diformat dengan mudah menjadi string rgba() CSS di JavaScript.

Halaman referensi ini tidak memiliki informasi tentang ruang warna absolut yang harus digunakan untuk menafsirkan nilai RGB—misalnya, sRGB, Adobe RGB, DCI-P3, dan BT.2020. Secara default, aplikasi harus menggunakan ruang warna sRGB.

Saat kesamaan warna perlu ditentukan, implementasi, kecuali didokumentasikan lain, memperlakukan dua warna sebagai sama jika semua nilai merah, hijau, biru, dan alfa masing-masing berbeda paling banyak 1e-5.

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

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

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

// ...
Representasi JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
Kolom
red

number

Jumlah merah dalam warna sebagai nilai dalam interval [0, 1].
green

number

Jumlah hijau dalam warna sebagai nilai dalam interval [0, 1].
blue

number

Jumlah biru dalam warna sebagai nilai dalam interval [0, 1].
alpha

number

Fraksi warna ini yang harus diterapkan ke piksel. Yaitu, warna piksel akhir ditentukan oleh persamaan:

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

Ini berarti bahwa nilai 1,0 berarti warna solid, sedangkan nilai 0,0 berarti warna yang sepenuhnya transparan. Kode ini menggunakan pesan wrapper, bukan skalar float sederhana sehingga memungkinkan untuk membedakan antara nilai default dan nilai yang tidak disetel. Jika dihilangkan, objek warna ini dirender sebagai warna solid (seolah-olah nilai alfa telah secara eksplisit diberikan dengan nilai 1,0).

DisplayHints

Petunjuk tampilan UI untuk merender opsi.

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

boolean

Apakah opsi harus ditampilkan di UI sebagai dinonaktifkan.
shownInApply

boolean

Opsi ini harus ditampilkan di menu terapkan saat menerapkan nilai ke item Drive.
badgeColors

object (BadgeColors)

Warna yang akan digunakan untuk badge. Diubah ke warna Material Google berdasarkan properties.badge_config.color yang dipilih.
darkBadgeColors

object (BadgeColors)

Warna mode gelap yang akan digunakan untuk badge. Diubah ke warna Material Google berdasarkan properties.badge_config.color yang dipilih.
badgePriority

string (int64 format)

Prioritas badge ini. Digunakan untuk membandingkan dan mengurutkan beberapa badge. Angka yang lebih rendah berarti badge harus ditampilkan terlebih dahulu. Jika konfigurasi badge tidak ada, nilainya adalah 0. Jika tidak, nilai ini akan ditetapkan ke BadgeConfig.priority_override atau heuristik default yang lebih mengutamakan tanggal pembuatan label, serta prioritas kolom dan opsi.

BadgeColors

Warna yang berasal dari BadgeConfig dan diubah ke warna yang didukung dan direkomendasikan terdekat.

Representasi JSON 
{
  "backgroundColor": {
    object (Color)
  },
  "foregroundColor": {
    object (Color)
  },
  "soloColor": {
    object (Color)
  }
}
Kolom
backgroundColor

object (Color)

Hanya output. Latar belakang badge yang cocok dengan latar depan.
foregroundColor

object (Color)

Hanya output. Latar depan badge yang dipasangkan dengan latar belakang.
soloColor

object (Color)

Hanya output. Warna yang dapat digunakan untuk teks tanpa latar belakang.

SchemaCapabilities

Kemampuan yang terkait dengan pilihan ini saat mengedit pilihan.

Representasi JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Kolom
canUpdate

boolean

Apakah pengguna dapat memperbarui pilihan ini.
canDelete

boolean

Apakah pengguna dapat menghapus pilihan ini.
canDisable

boolean

Apakah pengguna dapat menonaktifkan pilihan ini.
canEnable

boolean

Apakah pengguna dapat mengaktifkan pilihan ini.

AppliedCapabilities

Kemampuan yang terkait dengan pilihan ini pada metadata yang diterapkan.

Representasi JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canSelect": boolean
}
Kolom
canRead

boolean

Apakah pengguna dapat membaca metadata terapan terkait pada item.
canSelect

boolean

Apakah pengguna dapat memilih pilihan ini pada item.

LockStatus

Berisi informasi tentang apakah komponen label harus dianggap terkunci.

Representasi JSON 
{
  "locked": boolean
}
Kolom
locked

boolean

Hanya output. Menunjukkan apakah komponen label ini adalah target (langsung) penguncian label. Komponen label dapat dikunci secara implisit meskipun bukan target langsung penguncian label, dalam hal ini kolom ini ditetapkan ke salah (false).

UserOptions

Opsi untuk jenis kolom pengguna.

Representasi JSON 
{
  "listOptions": {
    object (ListOptions)
  }
}
Kolom
listOptions

object (ListOptions)

Jika ditentukan, menunjukkan bahwa kolom ini mendukung daftar nilai. Setelah kolom dipublikasikan, kolom ini tidak dapat diubah.

Properti

Properti dasar kolom.

Representasi JSON 
{
  "displayName": string,
  "required": boolean,
  "insertBeforeField": string
}
Kolom
displayName

string

Wajib. Teks tampilan yang akan ditampilkan di UI yang mengidentifikasi kolom ini.
required

boolean

Apakah kolom harus ditandai sebagai wajib diisi.
insertBeforeField

string

Hanya input. Sisipkan atau pindahkan kolom ini sebelum kolom yang ditunjukkan. Jika kosong, kolom ditempatkan di akhir daftar.

DisplayHints

Petunjuk tampilan UI untuk merender kolom.

Representasi JSON 
{
  "required": boolean,
  "disabled": boolean,
  "hiddenInSearch": boolean,
  "shownInApply": boolean
}
Kolom
required

boolean

Apakah kolom harus ditampilkan sebagai wajib diisi di UI.
disabled

boolean

Apakah kolom harus ditampilkan di UI sebagai dinonaktifkan.
shownInApply

boolean

Kolom ini harus ditampilkan di menu terapkan saat menerapkan nilai ke item Drive.

SchemaCapabilities

Kemampuan yang terkait dengan kolom ini saat mengedit kolom.

Representasi JSON 
{
  "canUpdate": boolean,
  "canDelete": boolean,
  "canDisable": boolean,
  "canEnable": boolean
}
Kolom
canUpdate

boolean

Apakah pengguna dapat mengubah kolom ini.
canDelete

boolean

Apakah pengguna dapat menghapus kolom ini. Pengguna harus memiliki izin dan kolom harus tidak digunakan lagi.
canDisable

boolean

Apakah pengguna dapat menonaktifkan kolom ini. Pengguna harus memiliki izin dan kolom ini belum boleh dinonaktifkan.
canEnable

boolean

Apakah pengguna dapat mengaktifkan kolom ini. Pengguna harus memiliki izin dan kolom ini harus dinonaktifkan.

AppliedCapabilities

Kemampuan yang terkait dengan kolom ini pada metadata yang diterapkan.

Representasi JSON 
{
  "canRead": boolean,
  "canSearch": boolean,
  "canWrite": boolean
}
Kolom
canRead

boolean

Apakah pengguna dapat membaca metadata terapan terkait pada item.
canWrite

boolean

Apakah pengguna dapat menyetel kolom ini pada item Drive.

EnabledAppSettings

Menjelaskan aplikasi Google Workspace tempat label dapat digunakan.

Representasi JSON 
{
  "enabledApps": [
    {
      object (EnabledApp)
    }
  ]
}
Kolom
enabledApps[]

object (EnabledApp)

Opsional. Daftar aplikasi tempat label dapat digunakan.

EnabledApp

Aplikasi tempat label dapat digunakan.

Representasi JSON 
{
  "app": enum (App)
}
Kolom
app

enum (App)

Opsional. Nama aplikasi.

Aplikasi

Kumpulan kemungkinan aplikasi Google Workspace tempat label dapat digunakan.

Enum
APP_UNSPECIFIED Tidak ditentukan
DRIVE Drive
GMAIL Gmail

Metode

create

 Membuat label.

delete

 Menghapus label dan metadata terkait pada item Drive secara permanen.

delta

 Memperbarui satu label dengan menerapkan serangkaian permintaan pembaruan yang menghasilkan revisi draf baru.

disable

 Menonaktifkan label yang dipublikasikan.

enable

 Aktifkan label yang dinonaktifkan dan pulihkan ke status yang dipublikasikan.

get

 Mendapatkan label berdasarkan nama resource-nya.

list

 Mencantumkan label.

publish

 Publikasikan semua perubahan draf ke label.

updateLabelCopyMode

 Memperbarui CopyMode label.

updateLabelEnabledAppSettings

 Memperbarui EnabledAppSettings label.

updatePermissions

 Memperbarui izin label.