- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- 요청
- UpdateLabelPropertiesRequest
- CreateFieldRequest
- UpdateFieldPropertiesRequest
- UpdateFieldTypeRequest
- LongTextOptions
- EnableFieldRequest
- DisableFieldRequest
- DeleteFieldRequest
- CreateSelectionChoiceRequest
- UpdateSelectionChoicePropertiesRequest
- EnableSelectionChoiceRequest
- DisableSelectionChoiceRequest
- DeleteSelectionChoiceRequest
- 응답
- UpdateLabelPropertiesResponse
- CreateFieldResponse
- UpdateFieldPropertiesResponse
- UpdateFieldTypeResponse
- EnableFieldResponse
- DisableFieldResponse
- DeleteFieldResponse
- CreateSelectionChoiceResponse
- UpdateSelectionChoicePropertiesResponse
- EnableSelectionChoiceResponse
- DisableSelectionChoiceResponse
- DeleteSelectionChoiceResponse
- 실습
일련의 업데이트 요청을 적용하여 단일 라벨을 업데이트하여 새로운 초안 버전이 생성됩니다. 일괄 업데이트는 '전부 아니면 전무'입니다. 업데이트 요청이 유효하지 않으면 변경사항이 적용되지 않습니다. Drive 항목에서 변경사항을 사용하려면 먼저 최종 초안 버전을 게시해야 합니다.
HTTP 요청
POST https://drivelabels.googleapis.com/v2/{name=labels/*}:delta
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
name |
필수 항목입니다. 업데이트할 라벨의 리소스 이름입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "writeControl": { object ( |
입력란 | |
---|---|
writeControl |
쓰기 요청이 실행되는 방식을 제어합니다. |
requests[] |
라벨에 적용할 업데이트 목록입니다. 요청은 지정된 순서대로 적용됩니다. |
useAdminAccess |
사용자의 관리자 인증 정보를 사용하려면 |
view |
지정하면 표시된 뷰에 속한 특정 필드만 반환됩니다. |
languageCode |
|
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
라벨 업데이트에 대한 응답입니다.
JSON 표현 |
---|
{ "responses": [ { object ( |
입력란 | |
---|---|
responses[] |
업데이트의 답글입니다. 이는 업데이트와 1:1로 매핑되지만 일부 요청에 대한 응답이 비어 있을 수도 있습니다. |
updatedLabel |
업데이트가 적용된 후의 라벨입니다. [BatchUpdateLabelResponse2.include_label_in_response] 가 |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
자세한 내용은 승인 가이드를 참조하세요.
요청
라벨에 적용할 단일 종류의 업데이트입니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드 kind . 업데이트 종류입니다. 정확히 1개의 필드가 필요합니다. kind 은 다음 중 하나여야 합니다. |
|
updateLabel |
라벨 속성을 업데이트합니다. |
createField |
새 필드를 만듭니다. |
updateField |
필드의 기본 속성을 업데이트합니다. |
updateFieldType |
필드 유형 또는 유형 옵션을 업데이트합니다. |
enableField |
필드를 사용 설정합니다. |
disableField |
필드를 사용 중지합니다. |
deleteField |
라벨에서 필드를 삭제합니다. |
createSelectionChoice |
선택 필드 내에 선택 항목을 만듭니다. |
updateSelectionChoiceProperties |
선택 필드에서 선택 속성을 업데이트합니다. |
enableSelectionChoice |
선택 필드에서 선택 항목을 사용 설정합니다. |
disableSelectionChoice |
선택 필드 내 선택 사용 중지 |
deleteSelectionChoice |
선택 입력란에서 선택항목 삭제 |
UpdateLabelPropertiesRequest
라벨의 기본 속성을 업데이트합니다.
JSON 표현 |
---|
{
"updateMask": string,
"properties": {
object ( |
입력란 | |
---|---|
updateMask |
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
properties |
필수 항목입니다. 업데이트할 라벨 속성입니다. |
CreateFieldRequest
라벨 내 필드 만들기 요청입니다.
JSON 표현 |
---|
{
"field": {
object ( |
입력란 | |
---|---|
field |
필수 항목입니다. 만들 필드입니다. |
UpdateFieldPropertiesRequest
필드 속성 업데이트 요청입니다.
JSON 표현 |
---|
{
"updateMask": string,
"id": string,
"properties": {
object ( |
입력란 | |
---|---|
updateMask |
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
id |
필수 항목입니다. 업데이트할 필드입니다. |
properties |
필수 항목입니다. 기본 필드 속성입니다. |
UpdateFieldTypeRequest
필드 유형 변경 요청입니다.
JSON 표현 |
---|
{ "updateMask": string, "id": string, // Union field |
입력란 | |
---|---|
updateMask |
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. |
id |
필수 항목입니다. 업데이트할 필드입니다. |
통합 필드
|
|
textOptions |
입력란을 텍스트로 업데이트합니다. |
longTextOptions |
필드를 긴 텍스트로 업데이트합니다. |
integerOptions |
필드를 정수로 업데이트합니다. |
dateOptions |
필드를 날짜로 업데이트합니다. |
selectionOptions |
입력란을 선택으로 업데이트합니다. |
userOptions |
필드를 사용자로 업데이트합니다. |
LongTextOptions
Long Text 필드 유형을 선택합니다.
JSON 표현 |
---|
{ "minLength": integer, "maxLength": integer } |
입력란 | |
---|---|
minLength |
출력 전용. 텍스트 필드 값의 최소 유효 길이입니다. |
maxLength |
출력 전용. 텍스트 필드 값의 최대 유효 길이입니다. |
EnableFieldRequest
필드 사용 설정 요청입니다.
JSON 표현 |
---|
{ "id": string } |
입력란 | |
---|---|
id |
필수 항목입니다. 사용 설정할 필드의 ID입니다. |
DisableFieldRequest
필드 사용 중지 요청입니다.
JSON 표현 |
---|
{
"updateMask": string,
"id": string,
"disabledPolicy": {
object ( |
입력란 | |
---|---|
updateMask |
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
id |
필수 항목입니다. 사용 중지할 필드의 키입니다. |
disabledPolicy |
필수 항목입니다. 필드에 사용 중지된 정책입니다. |
DeleteFieldRequest
필드 삭제 요청입니다.
JSON 표현 |
---|
{ "id": string } |
입력란 | |
---|---|
id |
필수 항목입니다. 삭제할 필드의 ID입니다. |
CreateSelectionChoiceRequest
선택 선택 생성 요청입니다.
JSON 표현 |
---|
{
"fieldId": string,
"choice": {
object ( |
입력란 | |
---|---|
fieldId |
필수 항목입니다. 선택을 생성할 선택 필드입니다. |
choice |
필수 항목입니다. 창작에 대한 선택 |
UpdateSelectionChoicePropertiesRequest
Choice 속성 업데이트 요청입니다.
JSON 표현 |
---|
{
"updateMask": string,
"fieldId": string,
"id": string,
"properties": {
object ( |
입력란 | |
---|---|
updateMask |
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
fieldId |
필수 항목입니다. 업데이트할 선택 필드입니다. |
id |
필수 항목입니다. 업데이트할 선택입니다. |
properties |
필수 항목입니다. 업데이트할 Choice 속성입니다. |
EnableSelectionChoiceRequest
선택 활성화를 요청합니다.
JSON 표현 |
---|
{ "fieldId": string, "id": string } |
입력란 | |
---|---|
fieldId |
필수 항목입니다. 선택을 사용할 선택 필드입니다. |
id |
필수 항목입니다. 사용 설정 여부입니다. |
DisableSelectionChoiceRequest
선택 사용 중지 요청입니다.
JSON 표현 |
---|
{
"updateMask": string,
"fieldId": string,
"id": string,
"disabledPolicy": {
object ( |
입력란 | |
---|---|
updateMask |
업데이트해야 하는 필드입니다. 하나 이상의 필드를 지정해야 합니다. 루트 |
fieldId |
필수 항목입니다. 선택을 비활성화할 선택 필드입니다. |
id |
필수 항목입니다. 사용 중지하도록 선택합니다. |
disabledPolicy |
필수 항목입니다. 업데이트할 정책입니다. |
DeleteSelectionChoiceRequest
선택 삭제 요청입니다.
JSON 표현 |
---|
{ "fieldId": string, "id": string } |
입력란 | |
---|---|
fieldId |
필수 항목입니다. 선택을 삭제할 선택 필드입니다. |
id |
필수 항목입니다. 삭제를 선택합니다. |
응답
업데이트의 단일 응답입니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드 response . 해당 요청에 대한 응답입니다. response 은 다음 중 하나여야 합니다. |
|
updateLabel |
라벨의 기본 속성을 업데이트했습니다. |
createField |
새 필드를 만듭니다. |
updateField |
필드의 기본 속성을 업데이트합니다. |
updateFieldType |
필드 유형 또는 유형 옵션을 업데이트합니다. |
enableField |
필드를 사용 설정합니다. |
disableField |
필드를 사용 중지합니다. |
deleteField |
라벨에서 필드를 삭제합니다. |
createSelectionChoice |
선택 필드에 추가할 새 선택 목록 옵션을 만듭니다. |
updateSelectionChoiceProperties |
선택 필드에서 선택을 업데이트합니다. |
enableSelectionChoice |
선택 필드 내에서 선택을 사용하도록 설정합니다. |
disableSelectionChoice |
선택 필드 내 선택을 비활성화합니다. |
deleteSelectionChoice |
선택 필드에서 선택을 삭제합니다. |
UpdateLabelPropertiesResponse
라벨 속성 업데이트 후의 응답입니다.
CreateFieldResponse
필드 생성 후 응답
JSON 표현 |
---|
{ "id": string, "priority": integer } |
입력란 | |
---|---|
id |
생성된 필드의 필드입니다. 만들기 요청에 키를 비워두면 키가 자동으로 생성되며 여기에서 확인할 수 있습니다. |
priority |
생성된 필드의 우선순위입니다. 필드 (1-n) 사이의 연속된 우선순위를 보장하기 위해 우선순위가 지정된 것에서 변경될 수 있습니다. |
UpdateFieldPropertiesResponse
필드 속성 업데이트 후의 응답입니다.
JSON 표현 |
---|
{ "priority": integer } |
입력란 | |
---|---|
priority |
업데이트된 필드의 우선순위입니다. 필드 (1-n) 사이의 연속된 우선순위를 보장하기 위해 우선순위가 지정된 것에서 변경될 수 있습니다. |
UpdateFieldTypeResponse
필드 유형 업데이트 후의 응답입니다.
EnableFieldResponse
필드 사용 설정 후 응답입니다.
DisableFieldResponse
응답 다음 필드가 사용 중지되었습니다.
DeleteFieldResponse
필드 삭제 후 응답입니다.
CreateSelectionChoiceResponse
선택 선택 생성 후 응답
JSON 표현 |
---|
{ "fieldId": string, "id": string } |
입력란 | |
---|---|
fieldId |
서버에서 생성한 필드의 ID입니다. |
id |
필드 내에서 생성된 선택 항목의 서버 생성 ID |
UpdateSelectionChoicePropertiesResponse
선택 선택 속성 업데이트 후의 응답입니다.
JSON 표현 |
---|
{ "priority": integer } |
입력란 | |
---|---|
priority |
업데이트된 선택 항목의 우선순위입니다. 선택 항목 사이에 연속된 우선순위 (1-n)를 보장하기 위해 우선순위가 지정된 것에서 변경될 수 있습니다. |
EnableSelectionChoiceResponse
선택 사용 설정 후 응답
DisableSelectionChoiceResponse
선택 후 사용 중지된 응답입니다.
DeleteSelectionChoiceResponse
선택 삭제에 대한 응답입니다.