REST Resource: indexing.datasources.items

리소스: 항목

파일, 폴더 또는 데이터베이스 레코드와 같은 검색 색인의 항목인 단일 객체를 나타냅니다.

JSON 표현 
{
  "name": string,
  "acl": {
    object (ItemAcl)
  },
  "metadata": {
    object (ItemMetadata)
  },
  "structuredData": {
    object (ItemStructuredData)
  },
  "content": {
    object (ItemContent)
  },
  "version": string,
  "status": {
    object (ItemStatus)
  },
  "queue": string,
  "payload": string,
  "itemType": enum (Item.ItemType)
}
필드
name

string

항목의 이름입니다. 형식: datasources/{sourceId}/items/{itemId}

필수 입력란입니다. 최대 길이는 1,536자(영문 기준)입니다.
acl

object (ItemAcl)

이 항목의 액세스 제어 목록입니다.
metadata

object (ItemMetadata)

메타데이터 정보입니다.
structuredData

object (ItemStructuredData)

데이터 소스의 스키마에 등록된 객체 정의를 준수해야 하는 상품의 구조화된 데이터입니다.
content

object (ItemContent)

색인을 생성하고 텍스트를 검색 가능하게 만들 항목 콘텐츠입니다.
version

string (bytes format)

필수 항목입니다. 색인 생성 시스템은 데이터 소스의 버전을 바이트 문자열로 저장하고 색인의 항목 버전을 어휘 순서 지정을 사용하여 큐에 추가된 항목의 버전과 비교합니다.

Cloud Search Indexing은 현재 색인이 생성된 항목의 버전보다 작거나 같은 버전 값을 가진 대기 중인 항목의 색인을 생성하거나 삭제하지 않습니다. 이 필드의 최대 길이는 1,024바이트입니다.

항목 버전이 삭제 프로세스에 미치는 영향에 관한 자세한 내용은 수동 삭제 후 버전 처리를 참고하세요.

base64 인코딩 문자열입니다.
status

object (ItemStatus)

항목의 상태입니다. 출력 전용 필드입니다.
queue

string

이 항목이 속한 현재 재생목록에 추가합니다. 최대 길이는 100자입니다.
payload

string (bytes format)

추가 상태 커넥터는 이 항목에 대해 저장할 수 있습니다. 최대 길이는 10,000바이트입니다.

base64 인코딩 문자열입니다.
itemType

enum (Item.ItemType)

이 항목의 유형입니다.

ItemAcl

항목의 액세스 제어 목록(ACL) 정보입니다. 자세한 내용은 ACL 매핑하기를 참고하세요.

JSON 표현 
{
  "inheritAclFrom": string,
  "aclInheritanceType": enum (ItemAcl.AclInheritanceType),
  "readers": [
    {
      object (Principal)
    }
  ],
  "deniedReaders": [
    {
      object (Principal)
    }
  ],
  "owners": [
    {
      object (Principal)
    }
  ]
}
필드
inheritAclFrom

string

액세스 권한 목록 (ACL)을 상속받을 항목의 이름입니다. 참고: ACL 상속은 하위 항목에 대한 액세스 권한만 제공하며 구조적 관계를 정의하지 않으며 대규모 항목 그룹을 편리하게 삭제할 수 있는 방법도 제공하지 않습니다. 색인에서 ACL 상위 항목을 삭제하면 inheritAclFrom 필드에서 상위 항목을 참조하는 하위 항목의 액세스 권한만 변경됩니다. 항목이 여전히 색인에 남아 있지만 검색 결과에 표시되지 않을 수 있습니다. 반대로 컨테이너 항목을 삭제하면 containerName 필드를 통해 컨테이너를 참조하는 모든 항목도 삭제됩니다. 이 필드의 최대 길이는 1,536자(영문 기준)입니다.
aclInheritanceType

enum (ItemAcl.AclInheritanceType)

항목이 상위 항목에서 ACL을 상속할 때 적용할 액세스 규칙의 유형을 설정합니다. 이 값은 항상 inheritAclFrom 필드와 함께 설정해야 합니다. 또한 inheritAclFrom 필드가 설정된 경우 이 필드는 유효한 AclInheritanceType으로 설정되어야 합니다.
readers[]

object (Principal)

검색 결과에서 항목을 볼 수 있는 주 구성원 목록입니다. 다른 항목에서 권한을 상속받거나 항목을 표시할 의도가 없는 경우(예: virtual containers) 선택사항입니다. 최대 요소 수는 1,000개입니다.
deniedReaders[]

object (Principal)

검색 결과에서 항목에 대한 액세스가 명시적으로 거부된 주 구성원 목록입니다. 주 구성원의 액세스가 기본적으로 거부되지만 거부된 리더를 사용하여 예외를 처리하고 허용된 리더 목록을 재정의합니다. 최대 요소 수는 100개입니다.
owners[]

object (Principal)

선택사항입니다. 항목의 소유자 목록입니다. 이 필드는 문서 액세스 권한과 관련이 없습니다. 하지만 이렇게 하면 쿼리 사용자가 소유자인 항목의 순위가 약간 상승합니다. 요소의 최대 개수는 5개입니다.

ItemAcl.AclInheritanceType

ACL 상속의 유형입니다.

열거형
NOT_APPLICABLE 이 항목이 ACL을 상속하지 않는 경우의 기본값입니다. inheritAclFrom가 비어 있으면 NOT_APPLICABLE을 사용합니다. ACL 상속이 없는 항목도 자체 readers 및 deniedReaders 필드를 통해 제공된 ACL을 가질 수 있습니다.
CHILD_OVERRIDE 승인 충돌 중에는 하위 항목의 ACL이 읽기 액세스를 결정합니다.
PARENT_OVERRIDE 승인 충돌 중에는 inheritAclFrom 필드에 지정된 상위 항목의 ACL이 읽기 액세스 권한을 결정합니다.
BOTH_PERMIT 이 항목과 inheritAclFrom 필드에 지정된 상위 항목 모두가 읽기 액세스를 허용하는 경우에만 액세스 권한이 부여됩니다.

주 구성원

사용자, 그룹 또는 도메인에 대한 참조입니다.

JSON 표현 
{

  // Union field principal can be only one of the following:
  "gsuitePrincipal": {
    object (GSuitePrincipal)
  },
  "userResourceName": string,
  "groupResourceName": string
  // End of list of possible types for union field principal.
}
필드

통합 필드 principal.

principal는 다음 중 하나여야 합니다.
gsuitePrincipal

object (GSuitePrincipal)

이 주 구성원이 Google Workspace 사용자, 그룹 또는 도메인입니다.
userResourceName

string

이 주 구성원은 외부 ID를 사용하여 식별된 사용자입니다. 이름 필드에는 Identitysources/{sourceId}/users/{ID} 형식으로 사용자 리소스 이름을 지정해야 합니다.
groupResourceName

string

이 주 구성원은 외부 ID를 사용하여 식별된 그룹입니다. 이름 필드에는 IDsources/{sourceId}/groups/{ID} 형식으로 그룹 리소스 이름을 지정해야 합니다.

ItemMetadata

항목에 사용할 수 있는 메타데이터 필드입니다.

JSON 표현 
{
  "title": string,
  "sourceRepositoryUrl": string,
  "containerName": string,
  "objectType": string,
  "createTime": string,
  "updateTime": string,
  "interactions": [
    {
      object (Interaction)
    }
  ],
  "contentLanguage": string,
  "mimeType": string,
  "searchQualityMetadata": {
    object (SearchQualityMetadata)
  },
  "keywords": [
    string
  ],
  "hash": string,
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}
필드
title

string

항목의 제목입니다. 지정된 경우 이 이름이 query.search 결과의 제목으로 표시됩니다. 최대 길이는 2,048자(영문 기준)입니다.
sourceRepositoryUrl

string

데이터를 제공하는 소스 저장소 링크 검색 결과는 이 링크를 제목에 적용합니다. 공백 또는 특수문자로 인해 Cloud 검색 결과 링크가 리디렉션 알림을 트리거할 수 있습니다. 이를 방지하려면 URL을 인코딩해야 합니다. 최대 길이는 2,048자(영문 기준)입니다.
containerName

string

이 항목의 컨테이너 이름입니다. 컨테이너 항목을 삭제하면 이 항목이 자동으로 삭제됩니다. 참고: ACL은 컨테이너 항목에서 상속되지 않습니다. 항목에 ACL 상속을 제공하려면 inheritAclFrom 필드를 사용합니다. 최대 길이는 1,536자(영문 기준)입니다.
objectType

string

항목의 유형입니다. 이 이름은 데이터 소스에 등록된 스키마의 객체 정의 이름과 일치해야 합니다. 예를 들어 데이터 소스의 스키마에 이름이 'document'인 객체 정의가 포함된 경우 해당 유형의 객체에 대한 항목 색인 생성 요청은 ObjectType을 'document'로 설정해야 합니다. 최대 길이는 256자(영문 기준)입니다.
createTime

string (Timestamp format)

소스 저장소에서 항목이 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

소스 저장소에서 항목이 마지막으로 수정된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
interactions[]

object (Interaction)

항목에 대한 상호작용 목록입니다. 상호작용은 query.search 품질을 개선하는 데 사용되지만 최종 사용자에게는 노출되지 않습니다. 최대 요소 수는 1,000개입니다.
contentLanguage

string

상품의 BCP-47 언어 코드(예: 'en-US') 또는 'sr-Latn'입니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. 최대 길이는 32자(영문 기준)입니다.
mimeType

string

소스 저장소에 있는 ItemContent.content의 원래 MIME 유형 최대 길이는 256자(영문 기준)입니다.
searchQualityMetadata

object (SearchQualityMetadata)

항목의 추가 검색 품질 메타데이터입니다.
keywords[]

string

항목과 일치해야 하는 추가 키워드 또는 구문입니다. 사용자 제작 콘텐츠에 내부적으로 사용됩니다. 최대 요소 수는 100개입니다. 최대 길이는 8,192자(영문 기준)입니다.
hash

string

API 호출자가 제공한 해싱 값입니다. items.push 메서드와 함께 사용하여 수정된 상태를 계산할 수 있습니다. 최대 길이는 2,048자(영문 기준)입니다.
contextAttributes[]

object (ContextAttribute)

상품과 관련하여 이름이 지정된 속성 집합입니다. 요청의 맥락에 따라 항목의 순위에 영향을 미치는 데 사용할 수 있습니다. 최대 요소 수는 10개입니다.

상호작용

사용자와 항목 간의 상호작용을 나타냅니다.

JSON 표현 
{
  "type": enum (Interaction.InteractionType),
  "principal": {
    object (Principal)
  },
  "interactionTime": string
}
필드
type

enum (Interaction.InteractionType)
principal

object (Principal)

항목에 대한 작업을 수행한 사용자입니다.
interactionTime

string (Timestamp format)

사용자가 항목에 대해 작업을 수행한 시간입니다. 단일 사용자에 대해 동일한 유형의 작업이 여러 개 존재하는 경우 가장 최근 작업만 기록됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

Interaction.InteractionType

사용자가 항목에서 수행한 활동의 유형입니다.

열거형
UNSPECIFIED 값이 올바르지 않습니다.
VIEW 이 상호작용은 사용자가 항목을 조회했음을 나타냅니다.
EDIT 이 상호작용은 사용자가 항목을 수정했음을 나타냅니다.

SearchQualityMetadata

항목의 추가 검색 품질 메타데이터입니다.

JSON 표현 
{
  "quality": number
}
필드
quality

number

항목의 품질을 나타내는 지표로, 검색 품질에 영향을 미치는 데 사용됩니다. 값은 0.0 (최저 화질)에서 1.0 (최고 화질) 사이여야 합니다. 기본값은 0.0입니다.

ContextAttribute

항목과 연결된 이름이 지정된 속성으로, 요청의 컨텍스트에 따라 항목의 순위에 영향을 미치는 데 사용할 수 있습니다.

JSON 표현 
{
  "name": string,
  "values": [
    string
  ]
}
필드
name

string

속성의 이름입니다. 비워둘 수 없습니다. 최대 길이는 32자(영문 기준)입니다. 이름은 문자로 시작해야 하며 문자 (A~Z, a~z) 또는 숫자 (0~9)만 포함할 수 있습니다. 이름은 일치 전에 정규화 (소문자)됩니다.
values[]

string

속성의 텍스트 값입니다. 최대 요소 수는 10개입니다. 배열에 있는 요소의 최대 길이는 32자(영문 기준)입니다. 값은 일치하기 전에 정규화됩니다 (소문자로 처리).

ItemStructuredData

항목에 사용할 수 있는 구조화된 데이터 필드입니다.

JSON 표현 
{
  "object": {
    object (StructuredDataObject)
  },
  "hash": string
}
필드
object

object (StructuredDataObject)

데이터 소스의 스키마에 등록된 객체 정의를 준수해야 하는 구조화된 데이터 객체입니다.
hash

string

API 호출자가 제공한 해싱 값입니다. items.push 메서드와 함께 사용하여 수정된 상태를 계산할 수 있습니다. 최대 길이는 2,048자(영문 기준)입니다.

StructuredDataObject

이름이 지정된 속성으로 구성된 구조화된 데이터 객체입니다.

JSON 표현 
{
  "properties": [
    {
      object (NamedProperty)
    }
  ]
}
필드
properties[]

object (NamedProperty)

객체의 속성입니다. 최대 요소 수는 1,000개입니다.

NamedProperty

구조화된 데이터의 유형이 지정된 이름-값 쌍입니다. 값 유형은 objectType 객체 정의의 name 속성에 등록된 유형과 같아야 합니다.

JSON 표현 
{
  "name": string,

  // Union field value can be only one of the following:
  "integerValues": {
    object (NamedProperty.IntegerValues)
  },
  "doubleValues": {
    object (NamedProperty.DoubleValues)
  },
  "timestampValues": {
    object (NamedProperty.TimestampValues)
  },
  "booleanValue": boolean,
  "objectValues": {
    object (NamedProperty.ObjectValues)
  },
  "enumValues": {
    object (NamedProperty.EnumValues)
  },
  "dateValues": {
    object (NamedProperty.DateValues)
  },
  "textValues": {
    object (NamedProperty.TextValues)
  },
  "htmlValues": {
    object (NamedProperty.HtmlValues)
  }
  // End of list of possible types for union field value.
}
필드
name

string

속성의 이름입니다. 이 이름은 스키마의 객체 정의에 등록된 속성의 이름과 일치해야 합니다. 이 속성의 최대 허용 길이는 256자(영문 기준)입니다.
통합 필드 value. 이름이 지정된 속성의 값입니다. 속성은 한 가지 유형의 값만 보유할 수 있습니다. value은 다음 중 하나여야 합니다.
integerValues

object (NamedProperty.IntegerValues)
doubleValues

object (NamedProperty.DoubleValues)
timestampValues

object (NamedProperty.TimestampValues)
booleanValue

boolean
objectValues

object (NamedProperty.ObjectValues)
enumValues

object (NamedProperty.EnumValues)
dateValues

object (NamedProperty.DateValues)
textValues

object (NamedProperty.TextValues)
htmlValues

object (NamedProperty.HtmlValues)

NamedProperty.IntegerValues

정수 값 목록입니다.

JSON 표현 
{
  "values": [
    string
  ]
}
필드
values[]

string (int64 format)

NamedProperty.DoubleValues

double 값의 목록입니다.

JSON 표현 
{
  "values": [
    number
  ]
}
필드
values[]

number

NamedProperty.TimestampValues

타임스탬프 값 목록입니다.

JSON 표현 
{
  "values": [
    string
  ]
}
필드
values[]

string (Timestamp format)

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

NamedProperty.ObjectValues

객체 값 목록입니다.

JSON 표현 
{
  "values": [
    {
      object (StructuredDataObject)
    }
  ]
}
필드
values[]

object (StructuredDataObject)

NamedProperty.EnumValues

enum 값 목록입니다.

JSON 표현 
{
  "values": [
    string
  ]
}
필드
values[]

string

문자열 값의 최대 허용 길이는 32자(영문 기준)입니다.

NamedProperty.DateValues

날짜 값 목록입니다.

JSON 표현 
{
  "values": [
    {
      object (Date)
    }
  ]
}
필드
values[]

object (Date)

NamedProperty.TextValues

텍스트 값 목록입니다.

JSON 표현 
{
  "values": [
    string
  ]
}
필드
values[]

string

텍스트 값의 최대 허용 길이는 2,048자(영문 기준)입니다.

NamedProperty.HtmlValues

HTML 값 목록입니다.

JSON 표현 
{
  "values": [
    string
  ]
}
필드
values[]

string

HTML 값의 최대 허용 길이는 2,048자입니다.

ItemContent

Cloud Search에서 색인을 생성하고 표시할 항목의 콘텐츠입니다. UTF-8로 인코딩된 문자열만 inlineContent로 허용됩니다. 바이너리가 아닌 콘텐츠를 업로드하는 경우 UTF-8로 인코딩되어야 합니다.

JSON 표현 
{
  "contentFormat": enum (ItemContent.ContentFormat),
  "hash": string,

  // Union field content can be only one of the following:
  "inlineContent": string,
  "contentDataRef": {
    object (UploadItemRef)
  }
  // End of list of possible types for union field content.
}
필드
contentFormat

enum (ItemContent.ContentFormat)
hash

string

콘텐츠에 대해 API 클라이언트에서 계산하고 제공하는 해싱 정보입니다. items.push 메서드와 함께 사용하여 수정된 상태를 계산할 수 있습니다. 최대 길이는 2,048자(영문 기준)입니다.

통합 필드 content.

content는 다음 중 하나여야 합니다.
inlineContent

string (bytes format)

update 메서드 내에 인라인으로 제공되는 콘텐츠. 최대 길이는 102,400바이트 (100KiB)입니다.

base64 인코딩 문자열입니다.
contentDataRef

object (UploadItemRef)

쓰기 메서드를 통해 이전에 업로드한 콘텐츠의 참조 ID를 업로드합니다.

ItemContent.ContentFormat

콘텐츠의 형식입니다. 형식이 RAW인 경우 콘텐츠는 mimeType에서 지정한 형식이어야 합니다.

열거형
UNSPECIFIED 값이 올바르지 않습니다.
HTML contentFormat은 HTML입니다.
TEXT contentFormat은 자유 텍스트입니다.
RAW contentFormat은 원시 바이트입니다.

UploadItemRef

업로드 세션 참조를 나타냅니다. 이 참조는 upload method를 통해 생성됩니다. 이 참조는 생성 후 30일 동안 유효합니다. 항목 콘텐츠 업데이트는 contentDataRef을 통해 업로드된 이 콘텐츠를 참조할 수 있습니다.

JSON 표현 
{
  "name": string
}
필드
name

string

콘텐츠 참조의 이름입니다. 최대 길이는 2,048자(영문 기준)입니다.

ItemStatus

여기에는 항목의 상태 및 오류가 포함됩니다.

JSON 표현 
{
  "code": enum (ItemStatus.Code),
  "processingErrors": [
    {
      object (ProcessingError)
    }
  ],
  "repositoryErrors": [
    {
      object (RepositoryError)
    }
  ]
}
필드
code

enum (ItemStatus.Code)

상태 코드입니다.

processingErrors[]

object (ProcessingError)

항목이 ERROR 상태인 경우의 오류 세부정보입니다.
repositoryErrors[]

object (RepositoryError)

커넥터에서 저장소 오류가 보고되었습니다.

ProcessingError

JSON 표현 
{
  "code": enum (ProcessingErrorCode),
  "errorMessage": string,
  "fieldViolations": [
    {
      object (FieldViolation)
    }
  ]
}
필드
code

enum (ProcessingErrorCode)

오류의 특성을 나타내는 오류 코드입니다.
errorMessage

string

오류에 대한 설명입니다.
fieldViolations[]

object (FieldViolation)

항목 필드가 잘못된 경우 이 필드에 유효성 검사 오류에 대한 세부정보가 포함됩니다.

ProcessingErrorCode

Cloud Search 서버에서 항목을 처리하는 중에 발생한 오류를 나타내는 코드입니다. 하나의 항목에 여러 개의 처리 오류가 있을 수 있습니다.

열거형
PROCESSING_ERROR_CODE_UNSPECIFIED 값만 입력하세요. 항목에서 이 값을 사용합니다.
MALFORMED_REQUEST 항목의 ACL, 메타데이터 또는 콘텐츠의 형식이 잘못되었거나 잘못된 상태입니다. FieldViolations에는 문제의 위치에 대한 세부정보가 포함되어 있습니다.
UNSUPPORTED_CONTENT_FORMAT 개수 형식은 지원되지 않습니다.
INDIRECT_BROKEN_ACL ACL이 손상된 다른 항목을 상속했거나 매핑되지 않은 하위 요소가 있는 그룹이 있어 ACL 정보가 불완전한 항목
ACL_CYCLE ACL 상속 그래프가 주기를 형성했습니다.

FieldViolation

JSON 표현 
{
  "field": string,
  "description": string
}
필드
field

string

위반 항목이 있는 필드의 경로입니다.
description

string

오류에 대한 설명입니다.

RepositoryError

커넥터가 소스 저장소와 통신할 때 발생하는 오류입니다.

JSON 표현 
{
  "type": enum (RepositoryError.Type),
  "httpStatusCode": integer,
  "errorMessage": string
}
필드
type

enum (RepositoryError.Type)

오류 유형입니다.
httpStatusCode

integer

오류 코드. HTTP 상태 코드의 정의와 일치합니다.
errorMessage

string

오류를 설명하는 메시지입니다. 메시지의 최대 허용 길이는 8,192자입니다.

RepositoryError.Type

저장소의 통신 문제에 대한 오류 코드 목록입니다.

열거형
UNKNOWN 알 수 없는 오류입니다.
NETWORK_ERROR 알 수 없거나 연결할 수 없는 호스트입니다.
DNS_ERROR DNS 서버가 응답하지 않는 등의 DNS 문제입니다.
CONNECTION_ERROR 저장소 서버에 연결할 수 없습니다.
AUTHENTICATION_ERROR 사용자 인증 정보가 잘못되어 인증에 실패했습니다.
AUTHORIZATION_ERROR 저장소에 대한 서비스 계정이 승인되지 않았습니다.
SERVER_ERROR 저장소 서버 오류입니다.
QUOTA_EXCEEDED 할당량을 초과했습니다.
SERVICE_UNAVAILABLE 서버를 일시적으로 사용할 수 없습니다.
CLIENT_ERROR 클라이언트 관련 오류(예: 저장소 서버에 대한 커넥터의 잘못된 요청)

Item.ItemType

열거형
UNSPECIFIED
CONTENT_ITEM 정보 제공 목적으로만 색인이 생성된 항목입니다. 이러한 항목은 containerName 또는 inheritAclFrom 필드에서 참조할 수 없습니다.
CONTAINER_ITEM 색인이 생성되고 다른 항목에 ACL을 제공하거나 다른 항목을 포함하는 것이 목적인 항목입니다.
VIRTUAL_CONTAINER_ITEM 색인이 생성되지 않지만 그 외의 용도는 CONTAINER_ITEM인 항목입니다.

메서드

delete

 지정된 리소스 이름의 Item resource을 삭제합니다.

deleteQueueItems

 큐의 모든 항목을 삭제합니다.

get

 항목 이름별로 Item resource를 가져옵니다.

index

 Item ACL, 메타데이터, 콘텐츠를 업데이트합니다.

list

 Item resources의 전체 또는 하위 집합을 나열합니다.

poll

 색인 생성 큐에서 예약되지 않은 항목을 폴링하고 세트를 예약된 것으로 표시하며, 우선순위가 가장 높은 ItemStatus에서 가장 오래된 타임스탬프가 있는 항목부터 시작합니다.

push

 항목을 나중에 폴링 및 업데이트할 수 있도록 대기열로 푸시합니다.

unreserve

 대기열에서 모든 항목을 예약 취소하여 항목이 모두 폴링되도록 합니다.

upload

 항목 콘텐츠를 업로드하기 위한 업로드 세션을 만듭니다.