Method: projects.locations.products.purge

ProductSet의 모든 Product 또는 ProductSet에 없는 모든 Product를 삭제하는 비동기 API입니다.

Product가 지정된 ProductSet와 다른 ProductSet의 구성원인 경우에도 해당 Product는 삭제됩니다.

이 작업이 완료될 때까지는 지정된 ProductSet를 삭제하지 않는 것이 좋습니다. 이 작업이 실행되는 동안 Product가 삭제될 수도 있으므로 이 제품을 삭제하는 동안 새 ProductSet에 일괄 삭제와 관련된 Product를 추가하지 않는 것이 좋습니다.

products.purge 작업은 실행취소할 수 없습니다. 따라서 삭제 후 데이터를 다시 가져와야 하는 경우를 위해 products.purge를 시작하기 전에 원래 사용된 csv 파일 (제품 세트를 처음 만든 경우)을 productSets.import에 보관하는 것이 좋습니다.

ProductSet에서 모든 Product를 삭제하고 빈 ProductSet를 다시 사용하여 새 Product를 빈 ProductSet로 다시 가져오려면 해당 ProductSet에 대한 products.purge 작업이 완료될 때까지 기다려야 합니다.

google.longrunning.Operation API를 사용하여 요청 진행 상태와 결과를 추적할 수 있습니다. Operation.metadata에는 BatchOperationMetadata가 포함됩니다. (진행 상태)

HTTP 요청

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*}/products:purge

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 입력란입니다. Product를 삭제할 프로젝트 및 위치입니다.

형식은 projects/PROJECT_ID/locations/LOC_ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "force": boolean,

  // Union field target can be only one of the following:
  "productSetPurgeConfig": {
    object (ProductSetPurgeConfig)
  },
  "deleteOrphanProducts": boolean
  // End of list of possible types for union field target.
}
필드
force

boolean

기본값은 false입니다. 실제로 삭제를 수행하려면 이 값을 true로 재정의합니다.

통합 필드 target. 삭제할 Product입니다. target은 다음 중 하나여야 합니다.
productSetPurgeConfig

object (ProductSetPurgeConfig)

삭제할 제품이 포함된 ProductSet를 지정합니다.

deleteOrphanProducts

boolean

deleteOrphanProducts가 true인 경우 ProductSet에 없는 모든 Product가 삭제됩니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

자세한 내용은 인증 개요를 참조하세요.

ProductSetPurgeConfig

삭제할 제품이 포함된 ProductSet를 제어하는 구성입니다.

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

string

삭제할 Product가 포함된 ProductSet입니다. Product가 다른 ProductSet와 productSetId의 구성원인 경우에도 해당 Product는 삭제됩니다.