Method: labels.publish

將所有草稿變更發布至標籤。標籤發布後可能無法回復草稿狀態。詳情請參閱 google.apps.drive.labels.v2.Lifecycle。

發布標籤會產生新的發布修訂版本。系統會刪除先前的所有草稿修訂版本，系統會保留之前發布的修訂版本，但會視需要自動刪除。

發布後，部分變更內容將會停用。一般來說，如果變更會導致該標籤的相關中繼資料失效，或是對現有中繼資料造成新的限制，就會遭到拒絕。舉例來說，在發布標籤後，系統會拒絕以下變更標籤：* 不能直接刪除標籤。必須先停用，才能刪除。* 欄位.FieldType 無法變更。* 變更「欄位驗證」選項無法拒絕先前接受的內容。* 減少項目數量上限。

HTTP 要求

POST https://drivelabels.googleapis.com/v2/{name=labels/*}:publish

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。標籤資源名稱。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "useAdminAccess": boolean,
  "writeControl": {
    object (WriteControl)
  },
  "languageCode": string
}
欄位
useAdminAccess

boolean

如要使用使用者的管理員憑證，請設為 true。伺服器會在授予存取權前，確認使用者是否為標籤的管理員。
writeControl

object (WriteControl)

提供寫入要求的執行方式控制。預設值為不設定，表示最後寫入。
languageCode

string

用於評估本地化欄位標籤的 BCP-47 語言代碼。如未指定，系統會使用預設設定語言的值。

回應主體

如果成功，回應主體會包含 Label 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

詳情請參閱授權指南。