REST Resource: labels

Resource: Label

Label menentukan taksonomi yang dapat diterapkan ke item Drive untuk mengatur dan menelusuri seluruh item. Label dapat berupa string sederhana, atau dapat berisi kolom yang mendeskripsikan 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)
  }
}
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 bersifat konsisten di antara revisi. Cocok dengan ekspresi reguler: ([a-zA-Z0-9])+

revisionId

string

Hanya output. ID revisi label. ID revisi dapat menjadi bagian dari label name bergantung pada permintaan yang diajukan. Revisi baru dibuat setiap kali properti label yang direvisi diubah. Cocok dengan ekspresi reguler: ([a-zA-Z0-9])+

labelType

enum (LabelType)

Wajib diisi. Jenis label.

creator

object (UserInfo)

Hanya output. Pengguna yang membuat label ini.

createTime

string (Timestamp format)

Hanya output. Waktu label ini dibuat.

revisionCreator

object (UserInfo)

Hanya output. Pengguna yang membuat revisi label ini.

revisionCreateTime

string (Timestamp format)

Hanya output. Waktu revisi label ini dibuat.

publisher

object (UserInfo)

Hanya output. Pengguna yang memublikasikan label ini. Nilai ini tidak ada artinya jika label tidak dipublikasikan.

publishTime

string (Timestamp format)

Hanya output. Waktu label ini dipublikasikan. Nilai ini tidak ada artinya jika label tidak dipublikasikan.

disabler

object (UserInfo)

Hanya output. Pengguna yang menonaktifkan label ini. Nilai ini tidak ada artinya jika label tidak dinonaktifkan.

disableTime

string (Timestamp format)

Hanya output. Waktu label ini dinonaktifkan. Nilai ini tidak ada artinya jika label tidak dinonaktifkan.

customer

string

Hanya output. Pelanggan yang memiliki label ini. Misalnya: "pelanggan/123abc789".

properties

object (Properties)

Wajib diisi. 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 di 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 akan ditampilkan kepada pengguna agar mereka dapat mempelajari lebih lanjut label ini dan cara penggunaannya.

lockStatus

object (LockStatus)

Hanya output. LockStatus dari 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 dapat diedit oleh admin. Mendukung beberapa fitur tambahan khusus admin.

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 diisi. Judul label.

description

string

Deskripsi label.

Lifecycle

Status siklus proses objek, seperti label, kolom, atau pilihan. Siklus proses menerapkan transisi berikut:

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

Status yang dipublikasikan dan dinonaktifkan memiliki beberapa karakteristik yang berbeda:

  • Dipublikasikan—Beberapa jenis perubahan mungkin dilakukan pada objek dalam status ini, yang dalam hal ini hasUnpublishedChanges akan menjadi true (benar). Selain itu, beberapa jenis perubahan tidak diizinkan. Secara umum, setiap perubahan yang akan membatalkan atau menyebabkan pembatasan baru pada metadata yang ada terkait label akan ditolak.
  • Nonaktif—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 pilihan 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 dapat 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 telah dinonaktifkan. Objek mungkin memiliki perubahan draf yang belum dipublikasikan, seperti yang ditunjukkan oleh hasUnpublishedChanges.
DELETED Objek telah dihapus.

DisabledPolicy

Kebijakan yang mengatur cara menangani label, kolom, atau pilihan pilihan yang dinonaktifkan dalam berbagai konteks.

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

boolean

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

  • Saat 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 akan ditampilkan di UI sebagai dinonaktifkan.

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 terkait metadata yang diterapkan label ini.

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

boolean

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

canApply

boolean

Apakah pengguna dapat menerapkan label ini ke item atau tidak.

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 atau tidak.

canDelete

boolean

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

canDisable

boolean

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

canEnable

boolean

Apakah pengguna dapat mengaktifkan label ini atau tidak. 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 menyalin nilai kolom dan label yang diterapkan saat item Drive disalin.

CopyMode

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

Enum
COPY_MODE_UNSPECIFIED Mode penyalinan belum ditentukan.
DO_NOT_COPY Nilai kolom dan label yang diterapkan tidak akan disalin secara default saat item Drive tempat item diterapkan disalin.
ALWAYS_COPY Nilai kolom dan label yang diterapkan selalu disalin saat item Drive tempatnya diterapkan disalin. Hanya admin yang dapat menggunakan mode ini.
COPY_APPLIABLE Nilai kolom dan label 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 disetel di 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 ekspresi reguler: ([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 di 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 kolom ini dibuat.

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 ada artinya jika kolom tidak dipublikasikan.

disabler

object (UserInfo)

Hanya output. Pengguna yang menonaktifkan kolom ini. Nilai ini tidak ada artinya jika kolom tidak dinonaktifkan.

disableTime

string (Timestamp format)

Hanya output. Waktu kolom ini dinonaktifkan. Nilai ini tidak ada artinya 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 dirender 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 belum ditentukan.
LONG_DATE Mencakup nama lengkap bulan. Misalnya, 12 Januari 1999 (MMMM d, y)
SHORT_DATE Singkat, numerik, representasi. Misalnya, 12/13/99 (M/d/yy)

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • 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, artinya kolom ini mendukung daftar nilai. Setelah kolom dipublikasikan, hal ini tidak dapat diubah.

choices[]

object (Choice)

Opsi yang tersedia untuk kolom pilihan ini. Urutan daftarnya konsisten, dan dimodifikasi dengan insertBeforeChoice.

ListOptions

Opsi untuk varian multi-nilai dari jenis kolom terkait.

Representasi JSON
{
  "maxEntries": integer
}
Kolom
maxEntries

integer

Jumlah entri maksimum 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 ekspresi reguler: ([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 pilihan ini dibuat.

updater

object (UserInfo)

Hanya output. Pengguna yang memperbarui pilihan ini terakhir.

updateTime

string (Timestamp format)

Hanya output. Waktu pilihan ini diperbarui terakhir.

publisher

object (UserInfo)

Hanya output. Pengguna yang memublikasikan pilihan ini. Nilai ini tidak ada artinya jika pilihan tidak dipublikasikan.

publishTime

string (Timestamp format)

Hanya output. Waktu pilihan ini dipublikasikan. Nilai ini tidak ada artinya jika pilihan tidak dipublikasikan.

disabler

object (UserInfo)

Hanya output. Pengguna yang menonaktifkan pilihan ini. Nilai ini tidak ada artinya jika opsi tidak dinonaktifkan.

disableTime

string (Timestamp format)

Hanya output. Waktu pilihan ini dinonaktifkan. Nilai ini tidak ada artinya jika pilihan tidak dinonaktifkan.

lockStatus

object (LockStatus)

Hanya output. LockStatus pilihan ini.

Properti

Properti dasar pilihan.

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

string

Wajib diisi. 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 disetel, label yang memiliki pilihan ini dianggap sebagai "label dengan badge".

insertBeforeChoice

string

Input saja. Masukkan 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, tidak ada badge yang dirender. Warna latar belakang, latar depan, dan solo (mode terang dan gelap) yang ditetapkan di sini akan diubah di UI Drive menjadi warna terdekat yang direkomendasikan dan direkomendasikan.

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 kemudahan konversi ke dan dari representasi warna dalam berbagai bahasa daripada kerapatan. Misalnya, kolom representasi ini dapat dengan mudah diberikan ke konstruktor java.awt.Color di Java; ini juga dapat dengan mudah diberikan ke metode +colorWithRed:green:blue:alpha UIColor di iOS; dan, hanya dengan sedikit upaya, dapat dengan mudah diformat 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 kesetaraan warna perlu ditentukan, implementasi, kecuali jika didokumentasikan sebaliknya, memperlakukan dua warna sama jika semua nilai merah, hijau, biru, dan alfa masing-masing berbeda paling banyak sebesar 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 secara eksplisit diberi 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 akan 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 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 di antara beberapa badge. Angka yang lebih rendah berarti badge harus ditampilkan terlebih dahulu. Jika konfigurasi badge tidak ada, nilainya akan menjadi 0. Jika tidak, nilai ini akan ditetapkan ke BadgeConfig.priority_override atau heuristik default yang memilih tanggal pembuatan label, serta prioritas kolom dan opsi.

BadgeColors

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

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

object (Color)

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

foregroundColor

object (Color)

Hanya output. Latar depan badge yang tersambung 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 atau tidak.

canDelete

boolean

Apakah pengguna dapat menghapus pilihan ini.

canDisable

boolean

Apakah pengguna dapat menonaktifkan pilihan ini atau tidak.

canEnable

boolean

Apakah pengguna dapat mengaktifkan pilihan ini atau tidak.

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 yang diterapkan terkait pada item.

canSelect

boolean

Apakah pengguna dapat memilih pilihan ini pada item.

LockStatus

Berisi informasi tentang apakah komponen label harus dianggap terkunci atau tidak.

Representasi JSON
{
  "locked": boolean
}
Kolom
locked

boolean

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

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, hal ini tidak dapat diubah.

Properti

Properti dasar kolom.

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

string

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

required

boolean

Apakah kolom harus ditandai sebagai wajib diisi.

insertBeforeField

string

Input saja. Sisipkan atau pindahkan kolom ini sebelum kolom yang ditunjukkan. Jika kosong, kolom tersebut akan 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 sebagaimana diperlukan 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 atau tidak.

canDelete

boolean

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

canDisable

boolean

Apakah pengguna dapat menonaktifkan kolom ini. Pengguna harus memiliki izin dan kolom ini tidak 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 yang diterapkan terkait pada item.

canWrite

boolean

Apakah pengguna dapat menetapkan kolom ini pada item Drive.

Metode

create

Membuat Label baru.

delete

Menghapus Label dan metadata terkait secara permanen di Item Drive.

delta

Memperbarui satu Label dengan menerapkan sekumpulan permintaan pembaruan yang menghasilkan revisi draf baru.

disable

Menonaktifkan Label yang dipublikasikan.

enable

Mengaktifkan Label yang dinonaktifkan dan memulihkannya ke statusnya sebagai dipublikasikan.

get

Dapatkan label berdasarkan nama resource-nya.

list

Mencantumkan label.

publish

Publikasikan semua perubahan draf ke Label.

updateLabelCopyMode

Memperbarui CopyMode Label.

updatePermissions

Memperbarui izin Label.