REST Resource: folders.approvalRequests

Resource: ApprovalRequest

Permintaan bagi pelanggan untuk menyetujui akses ke resource.

Representasi JSON 
{
  "name": string,
  "requestedResourceName": string,
  "requestedResourceProperties": {
    object (ResourceProperties)
  },
  "requestedReason": {
    object (AccessReason)
  },
  "requestedLocations": {
    object (AccessLocations)
  },
  "requestTime": string,
  "requestedExpiration": string,

  // Union field decision can be only one of the following:
  "approve": {
    object (ApproveDecision)
  },
  "dismiss": {
    object (DismissDecision)
  }
  // End of list of possible types for union field decision.
}
Kolom
name

string

Nama resource permintaan. Formatnya adalah "{projects|folders|organizations}/{id}/agreementRequests/{agreement_request}".
requestedResourceName

string

Resource yang memerlukan persetujuan. Format nama resource ditentukan di https://cloud.google.com/apis/design/resource_names. Nama sumber daya di sini dapat berupa nama sumber daya "lengkap" (mis. "//library.googleapis.com/shelves/shelf1/books/book2") atau nama sumber daya "relatif" (mis. "rak/rak1/buku/book2") seperti yang dijelaskan dalam spesifikasi nama sumber daya.
requestedResourceProperties

object (ResourceProperties)

Properti yang terkait dengan resource yang diwakili oleh requiredResourceName.
requestedReason

object (AccessReason)

Justifikasi terkait permintaan persetujuan.
requestedLocations

object (AccessLocations)

Lokasi yang sedang diminta persetujuannya.
requestTime

string (Timestamp format)

Waktu saat persetujuan diminta.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
requestedExpiration

string (Timestamp format)

Akhir masa berlaku yang diminta untuk persetujuan. Jika permintaan disetujui, akses akan diberikan mulai dari saat permintaan persetujuan hingga habis masa berlakunya.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
Kolom union decision. Keputusan saat ini terkait permintaan persetujuan. decision hanya ada berupa salah satu diantara berikut:
approve

object (ApproveDecision)

Akses disetujui.
dismiss

object (DismissDecision)

Permintaan ditolak.

ResourceProperties

Properti yang terkait dengan resource permintaan.

Representasi JSON 
{
  "excludesDescendants": boolean
}
Kolom
excludesDescendants

boolean

Apakah persetujuan akan mengecualikan turunan resource yang diminta.

AccessReason

Representasi JSON 
{
  "type": enum (Type),
  "detail": string
}
Kolom
type

enum (Type)

Jenis justifikasi akses.
detail

string

Detail selengkapnya tentang jenis alasan tertentu. Lihat komentar untuk setiap jenis di atas.

Jenis

Jenis justifikasi akses.

Enum
TYPE_UNSPECIFIED Nilai default untuk proto, tidak boleh digunakan.
CUSTOMER_INITIATED_SUPPORT

Pelanggan membuat permintaan atau mengajukan masalah yang mengharuskan akun utama mengakses data pelanggan. detail adalah format yang dimaksud ("#####" adalah ID masalah):

  • "Laporan Masukan: #####"
  • "Nomor Kasus: #####"
  • "ID Kasus: #####"
  • "Referensi E-PIN: #####"
  • "Google-#####"
  • "T-#####"
GOOGLE_INITIATED_SERVICE Kepala utama mengakses data pelanggan untuk mendiagnosis atau menyelesaikan dugaan masalah dalam layanan. Sering kali akses ini digunakan untuk mengonfirmasi bahwa pelanggan tidak terpengaruh oleh masalah layanan yang dicurigai atau untuk memperbaiki masalah sistem yang dapat dibatalkan.
GOOGLE_INITIATED_REVIEW Layanan yang dimulai Google untuk tujuan keamanan, penipuan, penyalahgunaan, atau kepatuhan.
THIRD_PARTY_DATA_REQUEST Akun utama diwajibkan untuk mengakses data pelanggan untuk menanggapi permintaan atau proses data pihak ketiga yang sah, termasuk proses hukum dari pelanggan itu sendiri.
GOOGLE_RESPONSE_TO_PRODUCTION_ALERT Kepala utama mengakses data pelanggan untuk mendiagnosis atau menyelesaikan dugaan masalah dalam layanan atau pemadaman layanan yang diketahui.

AccessLocations

Ruang kerja di rumah dan lokasi fisik kepala sekolah.

Representasi JSON 
{
  "principalOfficeCountry": string,
  "principalPhysicalLocationCountry": string
}
Kolom
principalOfficeCountry

string

Lokasi "kantor di rumah" kepala sekolah. Kode negara dua huruf (ISO 3166-1 alpha-2), seperti "US", "DE", atau "GB" atau kode wilayah. Dalam situasi tertentu, sistem Google mungkin merujuk pada kode wilayah, bukan kode negara. Kemungkinan Kode Wilayah:

  • ASI: Asia
  • EUR: Eropa
  • OCE: Oseania
  • AFR: Afrika
  • NAM: Amerika Utara
  • SAM: Amerika Selatan
  • ANT: Antarktika
  • SETIAP: Lokasi mana pun
principalPhysicalLocationCountry

string

Lokasi fisik akun utama pada saat akses. Kode negara dua huruf (ISO 3166-1 alpha-2), seperti "US", "DE", atau "GB" atau kode wilayah. Dalam situasi tertentu, sistem Google mungkin merujuk pada kode wilayah, bukan kode negara. Kemungkinan Kode Wilayah:

  • ASI: Asia
  • EUR: Eropa
  • OCE: Oseania
  • AFR: Afrika
  • NAM: Amerika Utara
  • SAM: Amerika Selatan
  • ANT: Antarktika
  • SETIAP: Lokasi mana pun

ApproveDecision

Keputusan telah dibuat untuk menyetujui akses ke sumber daya.

Representasi JSON 
{
  "approveTime": string,
  "expireTime": string,
  "invalidateTime": string,
  "signatureInfo": {
    object (SignatureInfo)
  },
  "autoApproved": boolean
}
Kolom
approveTime

string (Timestamp format)

Waktu saat persetujuan diberikan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
expireTime

string (Timestamp format)

Waktu saat persetujuan berakhir.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
invalidateTime

string (Timestamp format)

Jika ditetapkan, menunjukkan stempel waktu saat persetujuan menjadi tidak valid.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
signatureInfo

object (SignatureInfo)

Tanda tangan untuk Permintaan Persetujuan dan detail tentang cara menandatanganinya.
autoApproved

boolean

True jika permintaan telah disetujui secara otomatis.

SignatureInfo

Informasi tentang tanda tangan digital resource.

Representasi JSON 
{
  "signature": string,

  // Union field verification_info can be only one of the following:
  "googlePublicKeyPem": string,
  "customerKmsKeyVersion": string
  // End of list of possible types for union field verification_info.
}
Kolom
signature

string (bytes format)

Tanda tangan digital.

String berenkode base64.
Kolom union verification_info. Cara tanda tangan ini diverifikasi. verification_info hanya ada berupa salah satu diantara berikut:
googlePublicKeyPem

string

Kunci publik untuk penandatanganan default Google, dienkode dalam format PEM. Tanda tangan dibuat dengan menggunakan kunci pribadi yang dapat diverifikasi menggunakan kunci publik tersebut.
customerKmsKeyVersion

string

Nama resource CryptoKeyVersion pelanggan yang digunakan untuk penandatanganan.

DismissDecision

Keputusan yang telah dibuat untuk menolak permintaan persetujuan.

Representasi JSON 
{
  "dismissTime": string,
  "implicit": boolean
}
Kolom
dismissTime

string (Timestamp format)

Waktu saat permintaan persetujuan ditolak.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
implicit

boolean

Kolom ini akan bernilai benar (true) jika ApprovalRequest secara implisit ditolak karena tidak ada tindakan dari pemberi persetujuan persetujuan akses (permintaan tidak ditindaklanjuti oleh pemberi persetujuan sebelum waktu masa berlaku habis).

Metode

approve

 Menyetujui permintaan dan menampilkan ApprovalRequest yang diperbarui.

dismiss

 Menutup permintaan.

get

 Mendapatkan permintaan persetujuan.

invalidate

 Membatalkan validasi Permintaan Persetujuan yang ada.

list

 Mencantumkan permintaan persetujuan yang terkait dengan project, folder, atau organisasi.