이 페이지는 Cloud Translation API를 통해 번역되었습니다.

태그 인식기 가이드

태그 인식기 모델은 소매 진열대를 이해하는 데 있어 중요한 문제를 해결하는 데 도움이 됩니다. 즉, 사용자 정의 키-값 쌍 항목 추출 스키마에 따라 태그(예: 가격표 또는 기타 라벨 태그)를 인식하고 파싱합니다.

이 모델은 소매업체의 제품 이미지 데이터를 분석하고 해석하기 위한 기본 AI 구성요소로 사용할 수 있습니다. 예를 들어 로컬 카메라나 휴대기기로 캡처한 섹션 이미지에 이 모델을 사용할 수 있습니다.

태그 인식기 및 제품 인식기 사용 사례

제품 인식기 모델 및 태그 인식기 모델은 설치된 카메라나 휴대기기 / 플랫폼에서 캡처한 진열대 스캔 이미지와 같이 소매업체에서 발견되는 제품 및 태그와 관련된 이미지 데이터를 분석하고 해석하기 위한 기본 AI 구성요소 역할을 할 수 있습니다.

제품 인식기 및 태그 인식기 모델은 소매업체 또는 기술 파트너가 소매 진열대를 이해하는 데 있어 다음과 같은 주요 문제를 해결하는 데 도움이 되는 여러 핵심 Google AI 모델링 및 데이터 기능을 통합합니다.

이미지 또는 선반에 있는 제품을 감지, 인식하여 파악합니다.
사용자 정의 키-값 쌍 항목 추출 스키마에 따라 태그 (예: 가격표 또는 기타 텍스트 라벨 태그)를 감지, 인식, 파싱합니다.

특히 이러한 사용 사례 문제 해결을 지원하기 위해 다음과 같은 차별화된 Google AI 모델이 섹션 확인 솔루션에 포함되어 있습니다.

제품 감지 모델 (Google에서 사전 학습했지만 맞춤설정 가능)
제품 썸네일 이미지를 숫자형 특징 공간 표현으로 변환하는 제품 썸네일 시각적 임베딩 모델입니다.
이미지에 표시된 모든 텍스트를 추출하는 Google OCR 모델
원시 텍스트를 사용자 정의 키-값 쌍인 항목으로 변환하는 Google 항목 추출 모델 (맞춤설정 가능)

선반 관리 솔루션은 이러한 Google AI 모델 외에도 Google의 대규모 제품 정보 데이터베이스를 활용합니다. 이 제품 데이터베이스의 제품 데이터에는 제품의 GTIN / UPC ID, 제품 브랜드, 제품명, 교차 언어 설명, 제품 로고, 다양한 포장재가 포함된 이미지가 포함됩니다. 앞서 언급한 제품 썸네일 시각적 임베딩 모델이 포함된 제품 데이터베이스를 사용하면 제품 인식기 모델이 여러 제품을 즉시 인식할 수 있습니다.

예를 들어 다음과 같이 캡처된 섹션 이미지가 주어지면 섹션 확인 솔루션은 다음을 목표로 합니다.

이미지에서 모든 제품 상품 상자 (보이며 심각하게 가려지지 않음)를 감지하고 위치를 파악하며 GTIN / UPC 수준에서 각 개별 제품 상품 상자의 제품 ID를 인식합니다.
이미지에서 모든 태그 상자 (표시됨)를 감지하고 현지화한 후 태그의 모든 텍스트 문자열을 인식한 다음 텍스트를 제품 상품 설명, 가격 값과 같은 사용자 정의 키-값 쌍 엔터티 추출 스키마로 파싱합니다.

이러한 솔루션을 사용 설정하는 두 가지 주요 AI 기능은 제품 인식기 모델과 태그 인식기 모델이며, 다음 섹션에서 자세히 설명합니다. 주로 이미지 추론 서비스를 제공하는 두 API 각각에는 맞춤설정할 수 있는 구성요소가 하나 이상 있습니다. 먼저 API 사용의 추론 경로를 설명한 다음 사용자 구성이나 실행하는 모델 학습을 통해 관련 구성요소를 맞춤설정하는 방법을 간단히 설명합니다.

태그 인식기 기능

이 모델은 태그의 모든 텍스트 문자열을 인식한 후 텍스트를 제품 상품 설명이나 가격 값과 같은 사용자 정의 키-값 쌍 항목 추출 스키마로 파싱하려고 시도합니다. 여기에는 다음과 같은 차별화된 Google AI 모델이 포함됩니다.

이미지에서 보이는 모든 텍스트를 추출하는 Google OCR 기술
원시 텍스트를 사용자 정의 키-값 쌍인 명시적 항목으로 변환하는 Google 항목 추출 모델입니다. Vertex AI를 사용하여 이 모델을 맞춤설정합니다. 예를 들어 제품 상품 설명, 제품 가격 값 또는 할인가를 주로 고려하고 다른 것은 고려하지 않는 경우 다음과 같이 태그 파싱 스키마를 정의할 수 있습니다.
```
key: item_description   value: string
key: regular_price      value: number
key: sale_price         value: number
```

태그 파싱 스키마

맞춤설정된 항목 추출 모델을 학습하면 감지된 태그 항목 상자가 사용자 정의 스키마에 따라 인식되고 파싱됩니다(예: 다음과 같이).

  item_description:   COLLECTION 18PC GFT BX
  regular_price:      1099
  sale_price:         999

출력 JSON 객체 예시

{
  "imageUri": "gs://test_bucket/test_image.jpg",
  "tagRecognitionAnnotations": [
    {
      "entities": [
        {
          "confidence": 0.99646133,
          "mentionText": "NISSIN TOP RAMEN\n\nBOW CHICKEN\n\n",
          "region": {
            "xMax": 0.4618055,
            "xMin": 0.042725038,
            "yMax": 0.45387268,
            "yMin": 0.18415153
          },
          "type":"description"
        },
        {
          "confidence": 0.95828205,
          "mentionText": "$3.90\n",
          "region": {
            "xMax": 0.24819264,
            "xMin": 0.04185935,
            "yMax": 0.96134734,
            "yMin": 0.80382305
          },
          "type":"unit_price"
        },
        {
          "confidence": 0.60659707,
          "mentionText": "$14.99\n",
          "region": {
            "xMax": 0.9754113,
            "xMin": 0.3654699,
            "yMax": 0.92825794,
            "yMin": 0.40368474
          },
          "type":"price"
        }
      ]
    }
  ]
}

환경 설정

이 섹션에서는 Store Vision AI RESTful API와 상호작용하는 방법을 설명합니다.

API_ENDPOINT=visionai.googleapis.com
PROJECT_ID=your project ID

모든 create 메서드에는 생성할 리소스 이름/ID를 명시적으로 지정해야 합니다. 의미 있는 문자열 식별자(예: 'product-ABC') 또는 무작위로 생성된 식별자(예: UUID)를 사용할 수 있습니다.

사용자 역할에 Store Vision API를 사용할 수 있는 편집자 액세스 권한을 부여하려면 다음 IAM 바인딩 명령어를 실행하세요.

gcloud projects add-iam-policy-binding PROJECT_ID --member='user:USER_ACCOUNT' --role='roles/visionai.editor'

서비스 계정에 편집자 액세스 권한을 부여하려면 다음 명령어를 사용하세요.

gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:SERVICE_ACCOUNT' --role='roles/visionai.editor'

IAM 바인딩 자세히 알아보기

태그 인식기 사용자 여정

Vertex AI/AutoML Vision 객체 감지 기능을 사용하여 태그 감지 모델 맞춤설정 학습을 실행합니다.
맞춤설정된 OCR 엔진과 함께 Vertex AI/ AutoML Vision 객체 감지 기능을 사용하여 태그 항목 파싱 모델 학습을 실행합니다.
원하는 태그 인식 구성으로 엔드포인트를 만듭니다.
TagRecognition 기능으로 BatchAnalyze를 실행합니다. 백엔드에서 시스템은 각 입력 이미지의 태그를 식별하고 감지된 각 태그의 텍스트를 분석하여 구조화된 파싱 출력을 생성합니다. T ## 태그 감지 및 항목 파싱 모델 학습

기존 Vertex AI/ AutoML Vision 제품의 이미지 객체 감지 모델 학습 기능을 사용하여 맞춤설정된 태그 감지 모델을 학습할 수 있습니다. Vertex AI / AutoML Vision 객체 감지 모델 학습 기능은 완전 관리형 모델 학습 환경을 제공하지만, 모델 학습 콘솔에 제공할 학습 데이터 세트로 완전히 라벨이 지정된 객체 경계 상자 주석이 있는 잘 샘플링된 이미지 데이터 세트를 준비하는 것은 개발자의 책임입니다. Google Cloud 는 데이터 라벨 지정 작업을 만들 수 있는 Vertex AI 데이터 라벨 지정 서비스를 제공합니다. 자세한 내용은 다음 Vertex AI 데이터 라벨링 작업 링크(/vertex-ai/docs/datasets/data-labeling-job)를 참고하세요. 학습 데이터 세트 준비 단계에서 이미지의 태그 감지 경계 상자에 라벨을 지정하는 방법을 알 수 있도록 수동 평가자에게 명확한 데이터 라벨 지침을 제공합니다.

태그 항목 파싱 모델을 학습시키려면 이미지와 관련 주석이 포함된 학습 데이터 모음을 준비해야 합니다.

이미지는 이미 잘린 태그 이미지입니다.
각 이미지에서 감지 및 인식/파싱하려는 키 항목 필드 (예: product_title, price, unit_price 필드)와 이 잘린 이미지 뷰에서 관련 이미지 경계 상자 좌표 위치를 정의하고 제공해야 합니다.
올바른 인식 / 파싱을 지원하려면 각 필드를 특성화하는 정규 표현식 문법도 제공해야 합니다. 이는 태그 파싱 알고리즘의 학습 및 추론 루틴을 지원하는 데 필요합니다.

인식된 태그 이미지

태그 항목 파싱 학습 예시

예를 들어 이전 태그 엔터티 파싱 학습 예시를 사용하면 다음과 같이 학습 데이터 주석 CSV 파일에 주석 정보를 한 줄 제공할 수 있습니다.

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

이전 예시를 다시 보겠습니다.

'product_title' 필드에는 상응하는 상자 이미지 좌표 '(x0, y0, x1, y1)'이 있으며 이 필드의 정규 표현식 제약 조건은 없습니다.""
'price' 필드에는 상응하는 상자 이미지 좌표 '(x0, y0, x1, y1)'이 있으며 이 필드의 정규 표현식 제약 조건은 '\$\d+\.\d{2}'입니다. 이는 텍스트 입력의 시작 부분에 $ 기호가 있고 '.' 앞에 몇 개의 숫자 자리가 있으며 '.' 뒤에 2자리 숫자가 있는 이 필드를 인식하고 파싱하려고 함을 나타냅니다.
'unit_price' 필드는 'price' 필드와 동일한 주석 문법을 사용합니다. 예를 들어 상자 이미지 좌표 '(x0, y0, x1, y1)'이며 이 필드의 정규 표현식 제약 조건은 '\$\d+\.\d{2}'입니다. 이는 텍스트 입력의 시작 부분에 $ 기호가 있고 '.' 앞에 몇 자리 숫자가 있으며 '.' 뒤에 두 자리 숫자가 있는 필드를 인식하고 파싱하려고 함을 나타냅니다.

따라서 적절한 가격표 파싱 / 항목 감지 모델 학습 데이터에는 가격표 이미지 모음과 함께 각 CSV 행 항목이 있는 CSV 파일의 주석이 포함됩니다(이전 예의 항목과 동일).

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

"image_filepath", "product_title", "(x0, y0, x1, y1)", "", "price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}", "unit_price", "(x0, y0, x1, y1)", "\\$\\d+\\.\\d{2}"

[...]

기존 Vertex AI /AutoML Vision 제품의 이미지 객체 감지 모델 학습 기능과 Google OCR 엔진 맞춤설정을 사용하여 맞춤설정된 태그 엔터티 파싱 모델을 학습할 수 있습니다.

2022년 7월 현재 맞춤 태그 감지 및 태그 항목 파싱 모델 학습과 Store Vision AI의 BatchAnalyze API에 대한 배포는 아직 통합 콘솔 환경으로 완전히 지원되지 않지만, 몇 가지 수동 셀프 서비스 단계를 거쳐 Vertex AI Vision의 객체 감지 기능을 사용하여 이 맞춤 태그 감지 및 태그 항목 파싱 모델 학습을 활용하고 Store Vision AI의 BatchAnalyze API에 제공할 수 있습니다.

API 사용 - 일괄 추론 분석

엔드포인트 만들기

ENDPOINT_ID=엔드포인트 ID
TAG_DETECTOR=태그 감지 모델 이름
TAG_PARSER=태그 파싱 모델 이름

curl -sS -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints?retail_endpoint_id=ENDPOINT_ID \
-d '{
  "tagRecognitionConfig": {
    "tag_detection_model": "TAG_DETECTOR_NAME",
    "tag_parsing_model": "TAG_PARSER_NAME"
  }
}'

INPUT_FILE_URI=입력 파일의 Cloud Storage uri입니다. 입력 파일의 각 행은 처리할 이미지의 Cloud Storage uri일 뿐입니다(예: gs://my-bucket/my-image.jpg).
OUTPUT_URI_PREFIX=출력 결과 파일의 Cloud Storage URI 접두사(예: gs://my-bucket/my-output-dir)

curl -sS -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" https://visionai.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/us-central1/retailEndpoints/ENDPOINT_ID:batchAnalyze 
-d '{
  "gcsSource": {
    "uris": ["INPUT_FILE_URI"]
  },
  "features": [
    {
      "type": "TYPE_TAG_RECOGNITION",
     }
  ],
  "outputGcsDestination": {
    "outputUriPrefix": "OUTPUT_URI_PREFIX"
  }
}'

"features": [
    {
      "type": "TYPE_TAG_RECOGNITION",
      "tagRecognitionConfig": {
        "tag_detection_model": "'TAG_DETECTOR_NAME'",
        "tag_parsing_model": "TAG_PARSER_NAME"
      }
    }
  ],

RetailTagRecognitionConfig 객체인 tagRecognitionConfig에서 설정하고 구성할 수 있는 필드도 더 있습니다. 자세한 내용은 API 참조의 리소스 설명을 참고하세요.

API 참조

리소스: projects.locations.retailCatalogs

JSON 표현

{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "resourceState": enum(RetailResourceState),
  "labels": {
    string: string,
    ...
  }
}

필드

이름	문자열	출력 전용입니다. RetailCatalog의 리소스 이름
displayName	문자열	선택사항입니다. RetailCatalog의 표시 이름입니다.
createTime	문자열 (타임스탬프 형식)	출력 전용입니다. 이 RetailCatalog가 생성된 타임스탬프입니다.
updateTime	문자열 (타임스탬프 형식)	출력 전용입니다. 업데이트 타임스탬프입니다.
resourceState	열거형	출력 전용입니다. RetailCatalog의 상태입니다.
라벨	맵 (키: 문자열, 값: 문자열)	RetailCatalog를 구성하는 사용자 정의 메타데이터가 있는 라벨입니다. 라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다. 라벨에 대한 자세한 내용과 예시는 https://goo.gl/xmQnxf를 참고하세요. '키': 값 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

메서드: projects.locations.retailCatalogs.create

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/us-central1}/retailCatalogs

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

요청 본문

요청 본문에 RetailCatalog의 인스턴스가 포함됩니다.

응답 본문

성공하면 응답 본문에 새로 생성된 RetailCatalog 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.get

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/us-central1/retailCatalogs/*}

경로 매개변수


name	문자열	필수 입력란입니다. `RetailCatalog` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

메서드: projects.locations.retailCatalogs.list

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/us-central1}/retailCatalogs

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

쿼리 매개변수

filter	문자열	선택사항입니다. 요청 결과를 필터링하는 표현식입니다.
pageToken	문자열	선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
pageSize	정수	선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
orderBy	문자열	선택사항입니다. 오름차순으로 정렬된 정렬 기준 필드의 쉼표로 구분된 목록입니다. 내림차순으로 표시하려면 필드 이름 뒤에 'desc'를 사용합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다. JSON 표현

{
  "retailCatalogs": [
    {
      object (RetailCatalog)
    }
  ],
  "nextPageToken": string
}

메서드: projects.locations.retailCatalogs.delete

HTTP 요청

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/us-central1/retailCatalogs/*}

경로 매개변수


name	문자열	필수 입력란입니다. `RetailCatalog` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

메서드: projects.locations.retailCatalogs.importRetailProducts

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/us-central1/retailCatalogs/*}:importRetailProducts

경로 매개변수


name	문자열	필수 입력란입니다. `RetailCatalog` 리소스 이름입니다.

요청 본문

JSON 표현

{
  "gcsSource": { object(GcsSource) },
  "format": enum(Format)
}

필드

gcsSource	객체	필수 입력란입니다. 입력 콘텐츠의 Cloud Storage 위치입니다. 입력 위치를 여러 개 제공할 수 있습니다. 모든 입력 위치의 콘텐츠가 한 번에 가져옵니다. 지원되는 파일 확장자: 1. JSONL 파일 각 줄은 RetailProductIoFormat의 JSON 형식입니다. 2. TXT 파일 각 줄은 가져올 제품의 GTIN입니다.
서식	enum	필수 입력란입니다. 가져오기 파일 형식입니다.

ENUM 값 형식 지정

FORMAT_UNSPECIFIED	사용해서는 안 됩니다.
FORMAT_TXT	TXT 형식입니다.
FORMAT_JSONL	JSONL 형식입니다.

응답 본문

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

리소스: projects.locations.retailProducts

JSON 표현

{
  "name": string,
  "gtins": [string],
  "normalizedGtins": [string],
  "thirdPartyIds": [ { object(ThirdPartyId) }],
  "locale": string,
  "brand": string,
  "title": string,
  "productUri": string,
  "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

필드

이름	문자열	출력 전용입니다. RetailProductImage의 리소스 이름
displayName	문자열	선택사항입니다. RetailProductImage의 표시 이름입니다.
sourceType	열거형	선택사항입니다. 소스 유형
gcsUri	문자열	선택사항입니다. RetailProductImage의 Cloud Storage 위치입니다. 소스 유형이 SOURCE_TYPE_GOOGLE인 경우 등 Google에서 이미지를 제공하는 경우를 제외하고 설정해야 합니다.
resourceState	열거형	출력 전용입니다. RetailProductImage의 상태입니다.
라벨	맵 (키: 문자열, 값: 문자열)	RetailProductImage를 구성하는 사용자 정의 메타데이터가 있는 라벨입니다. 라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다. 라벨에 대한 자세한 내용과 예시는 https://goo.gl/xmQnxf를 참고하세요. '키': 값 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp 형식)	출력 전용입니다. 생성 타임스탬프입니다.
updateTime	string (Timestamp 형식)	출력 전용입니다. 업데이트 타임스탬프입니다.

RetailThirdPartyId JSON 프레젠테이션

{
  "id": string,
  "owner": string
}

필드


id	문자열	소매업체 또는 제조업체에서 사용하는 서드 파티 ID(예: SKU 또는 MPN)입니다.
owner	문자열	서드 파티 식별자를 '소유'하는 법인(예: 이 제품을 판매하는 제조업체 또는 소매업체)입니다.

메서드: projects.locations.retailCatalogs.retailProducts.create

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProducts

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

요청 본문

요청 본문에 RetailProduct의 인스턴스가 포함됩니다.

응답 본문

성공하면 응답 본문에 새로 생성된 RetailProduct 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.retailProducts.get

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*

경로 매개변수


name	문자열	필수 입력란입니다. `RetailProduct` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

메서드: projects.locations.retailCatalogs.retailProducts.list

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProducts

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

쿼리 매개변수

filter	문자열	선택사항입니다. 요청 결과를 필터링하는 표현식입니다.
pageToken	문자열	선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
pageSize	정수	선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
orderBy	문자열	선택사항입니다. 오름차순으로 정렬된 정렬 기준 필드의 쉼표로 구분된 목록입니다. 내림차순으로 표시하려면 필드 이름 뒤에 'desc'를 사용합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다. JSON 표현

{
  "retailProducts": [
    {
      object (RetailProducts)
    }
  ],
  "nextPageToken": string
}

메서드: projects.locations.retailCatalogs.retailProducts.delete

HTTP 요청

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*

경로 매개변수


name	문자열	필수 입력란입니다. `RetailProduct` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

리소스: projects.locations.retailProductImages

JSON 표현

{
  "name": string,
  "displayName": string,
  "sourceType": enum(SourceType),
  "gcsUri": string,
  "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

필드

이름	문자열	출력 전용입니다. RetailProductImage의 리소스 이름
displayName	문자열	선택사항. RetailProductImage의 표시 이름입니다.
sourceType	enum	선택사항. 소스 유형
gcsUri	문자열	선택사항. RetailProductImage의 Cloud Storage 위치입니다. 소스 유형이 SOURCE_TYPE_GOOGLE인 경우 등 Google에서 이미지를 제공하는 경우를 제외하고 설정해야 합니다.
resourceState	enum	출력 전용입니다. RetailProductImage의 상태입니다.
라벨 개	맵 (키: 문자열, 값: 문자열)	RetailProductImage를 구성하는 사용자 정의 메타데이터가 있는 라벨입니다. 라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다. 라벨에 대한 자세한 내용과 예시는 https://goo.gl/xmQnxf를 참고하세요. '키': 값 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	문자열 (타임스탬프 형식)	출력 전용입니다. 생성 타임스탬프입니다.
updateTime	문자열 (타임스탬프 형식)	출력 전용입니다. 업데이트 타임스탬프입니다.

SourceType ENUM 값

SOURCE_TYPE_UNSPECIFIED	알 수 없는 데이터 소스입니다. 사용해서는 안 됩니다.
SOURCE_TYPE_FIXED_CAMERA	고정된 카메라에서 이미지를 캡처합니다.
SOURCE_TYPE_HAND_HELD_CAMERA	휴대용 카메라에서 이미지를 캡처합니다.
SOURCE_TYPE_CRAWLED	웹에서 이미지를 크롤링합니다.
SOURCE_TYPE_SYSTEM_GENERATED	이미지는 사람이 라벨을 지정한 원본 이미지에서 잘립니다.

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.create

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*/retailProducts/*}/retailProductImages

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

요청 본문

요청 본문에 RetailProductImage의 인스턴스가 포함됩니다.

응답 본문

성공하면 응답 본문에 새로 생성된 RetailProductImage 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.get

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*/retailProductImages/*

경로 매개변수


name	문자열	필수 입력란입니다. `RetailProductImage` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.list

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*/retailProducts/*}/retailProductImages

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

쿼리 매개변수

filter	문자열	선택사항입니다. 요청 결과를 필터링하는 표현식입니다.
pageToken	문자열	선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
pageSize	정수	선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
orderBy	문자열	선택사항입니다. 오름차순으로 정렬된 정렬 기준 필드의 쉼표로 구분된 목록입니다. 내림차순으로 표시하려면 필드 이름 뒤에 'desc'를 사용합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현

{
  "retailProductImages": [
    {
      object (RetailProductImages)
    }
  ],
  "nextPageToken": string
}

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.delete

HTTP 요청

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProducts/*/retailProductImages/*

경로 매개변수


name	문자열	필수 입력란입니다. `RetailProductImage` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

리소스: projects.locations.retailCatalogs.retailProductSets

JSON 표현

{
  "name": string,
  "displayName": string,
  "retailProductIds": [string],
  "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

필드

이름	문자열	출력 전용입니다. RetailProductSet의 리소스 이름
displayName	문자열	선택사항입니다. RetailProductSet의 표시 이름입니다.
retailProductIds []	문자열	출력 전용입니다. 이 RetailProductSet에 속한 제품의 리소스 ID입니다. RetailProductSet의 제품은 동일한 카탈로그에 있어야 합니다.
resourceState	열거형	출력 전용입니다. RetailProductSet의 상태입니다.
라벨	맵 (키: 문자열, 값: 문자열)	RetailProductSet을 구성하는 사용자 정의 메타데이터가 있는 라벨입니다. 라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다. 라벨에 대한 자세한 내용과 예시는 https://goo.gl/xmQnxf를 참고하세요. '키': 값 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp 형식)	출력 전용입니다. 생성 타임스탬프입니다.
updateTime	string (Timestamp 형식)	출력 전용입니다. 업데이트 타임스탬프입니다.

메서드: projects.locations.retailCatalogs.retailProductSets.create

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductSets

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

요청 본문

요청 본문에는 RetailProductSet의 인스턴스가 포함됩니다.

응답 본문

성공하면 응답 본문에 새로 생성된 RetailProductSet 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.retailProductSets.get

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*

경로 매개변수


name	문자열	필수 입력란입니다. RetailProductSet 식별자입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공하면 응답 본문에 RetailProductSet 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.retailProductSets.list

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductSets

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

쿼리 매개변수

filter	문자열	선택사항입니다. 요청 결과를 필터링하는 표현식입니다.
pageToken	문자열	선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
pageSize	정수	선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
orderBy	문자열	선택사항입니다. 오름차순으로 정렬된 정렬 기준 필드의 쉼표로 구분된 목록입니다. 내림차순으로 표시하려면 필드 이름 뒤에 'desc'를 사용합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현

{
  "retailProductSets": [
    {
      object (RetailProductSets)
    }
  ],
  "nextPageToken": string
}

메서드: projects.locations.retailCatalogs.retailProductSets.delete

HTTP 요청

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*

경로 매개변수


name	문자열	필수 입력란입니다. RetailProductSet 식별자입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

메서드: projects.locations.retailCatalogs.retailProductSets.add

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*}:remove

경로 매개변수


name	문자열	필수 입력란입니다. RetailProductSet 리소스 이름입니다.

요청 본문

JSON 표현

{
  "productIds": [string],
  "productFilter": string
}

필드

productIds[ ]	문자열	추가할 RetailProducts의 리소스 ID입니다. 모두 지정된 대상 RetailProductSet과 동일한 RetailCatalog에 속해야 합니다. 한 번의 요청으로 최대 200개의 RetailProducts ID를 지정할 수 있습니다. productFilter와 함께 사용할 수 없습니다.
productFilter	문자열	상위 RetailCatalog의 모든 RetailProducts에 적용되는 표준 필터로, 필터 조건을 충족하는 항목을 선택하고 RetailProductSet에 추가합니다. product_ids와 함께 사용할 수 없습니다. 지원되는 필터: https://google.aip.dev/160

응답 본문

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

메서드: projects.locations.retailCatalogs.retailProductSets.remove

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductSets/*}:add

경로 매개변수


name	문자열	필수 입력란입니다. RetailProductSet 리소스 이름입니다.

요청 본문

JSON 표현

{
  "productIds": [string],
  "productFilter": string
}

필드

productIds[ ]	문자열	삭제할 RetailProducts의 리소스 ID입니다. 지정된 RetailProducts가 이 RetailProductSet에 속하지 않으면 무시됩니다. 한 번의 요청으로 최대 200개의 RetailProducts ID를 지정할 수 있습니다. products_filter와 함께 사용할 수 없습니다.
productFilter	문자열	지정된 RetailProductSet의 모든 RetailProducts에 적용되는 표준 필터로, 필터 조건을 충족하는 항목을 선택하고 RetailProductSet에서 삭제합니다. product_ids와 함께 사용할 수 없습니다. 지원되는 필터:https://google.aip.dev/160

응답 본문

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

리소스: projects.locations.retailCatalogs.retailProductRecognitionIndexes

JSON 표현

{
  "name": string,
  "displayName": string,
  "description": string,
  "retailProductSet": [string],
   "resourceState": enum(RetailResourceState),
   "labels": {
    string: string,
    ...
    }
   "createTime": string,
   "updateTime": string
}

필드

이름	문자열	출력 전용입니다. RetailProductRecognitionIndex 리소스의 리소스 이름입니다.
displayName	문자열	선택사항. RetailProductRecognitionIndex의 표시 이름입니다.
설명	문자열	선택사항. RetailProductRecognitionIndex에 대한 설명입니다.
retailProductSet[]	문자열	선택사항. 이 리소스를 만드는 데 사용할 RetailProductSet의 리소스 이름입니다. 이 속성을 설정하면 RetailProductRecognitionIndex에 지정된 RetailProductSet의 제품만 포함됩니다. 설정하지 않으면 상위 카탈로그의 모든 제품이 사용됩니다.
resourceState	enum	출력 전용입니다. RetailProductRecognitionIndex의 상태입니다.
라벨 개	맵 (키: 문자열, 값: 문자열)	RetailProductRecognitionIndex를 구성하는 사용자 정의 메타데이터가 있는 라벨입니다. 라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다. 라벨에 대한 자세한 내용과 예시는 https://goo.gl/xmQnxf를 참고하세요. '키': 값 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp 형식)	출력 전용입니다. 생성 타임스탬프입니다.
updateTime	string (Timestamp 형식)	출력 전용입니다. 업데이트 타임스탬프입니다.

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.create

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductRecognitionIndexes

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

요청 본문

요청 본문에 RetailProductRecognitionIndex의 인스턴스가 포함됩니다.

응답 본문

성공하면 응답 본문에 새로 생성된 RetailProductRecognitionIndex 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.get

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductRecognitionIndexes/*

경로 매개변수


name	문자열	필수 입력란입니다. `RetailProductRecognitionIndex` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

요청이 성공하면 응답 본문에 RetailProductRecognitionIndex 인스턴스가 포함됩니다.

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.list

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*/retailCatalogs/*}/retailProductRecognitionIndexes

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

쿼리 매개변수

filter	문자열	선택사항입니다. 요청 결과를 필터링하는 표현식입니다.
pageToken	문자열	선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
pageSize	정수	선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
orderBy	문자열	선택사항입니다. 오름차순으로 정렬된 정렬 기준 필드의 쉼표로 구분된 목록입니다. 내림차순으로 표시하려면 필드 이름 뒤에 'desc'를 사용합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현

{
  "retailProductRecognitionIndexes": [
    {
      object (RetailProductRecognitionIndex)
    }
  ],
  "nextPageToken": string
}

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.delete

HTTP 요청

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailCatalogs/*/retailProductRecognitionIndexes/*

경로 매개변수


name	문자열	필수 입력란입니다. ProductRecognitionIndex 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

리소스: projects.locations.retailEndpoints

JSON 표현

{
  "name": string,
  "displayName": string,
  "description": string,
  "deployedProductRecognitionIndex": string,
  "resourceState": enum(RetailResourceState),
  "productRecognitionConfig": { object(RetailProductRecognitionConfig) },
  "tagRecognitionConfig": { object(RetailTagRecognitionConfig) },
  "labels": {
    string: string,
    ...
   }
  "createTime": string,
  "updateTime": string
}

필드

이름	문자열	출력 전용입니다. RetailEndpoint 리소스의 리소스 이름입니다.
displayName	문자열	선택사항. RetailEndpoint의 표시 이름입니다.
설명	문자열	선택사항. RetailEndpoint에 대한 설명입니다.
deployedProductRecognitionIndex	문자열	출력 전용입니다. 이 RetailEndpoint에 배포된 ProductRecognitionIndex의 리소스 이름입니다.
productRecognitionConfig	객체	선택사항. 제품 인식을 위한 구성입니다.
tagRecognitionConfig	객체	선택사항. 태그 인식을 위한 구성입니다.
resourceState	enum	출력 전용입니다. RetailProductRecognitionIndex의 상태입니다.
라벨 개	맵 (키: 문자열, 값: 문자열)	RetailProductRecognitionIndex를 구성하는 사용자 정의 메타데이터가 있는 라벨입니다. 라벨 키와 값은 64자 (유니코드 코드 포인트) 이하여야 하며 소문자, 숫자, 밑줄, 대시만 포함할 수 있습니다. 국제 문자는 허용됩니다. 라벨에 대한 자세한 내용과 예시는 https://goo.gl/xmQnxf를 참고하세요. '키': 값 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime	string (Timestamp 형식)	출력 전용입니다. 생성 타임스탬프입니다.
updateTime	string (Timestamp 형식)	출력 전용입니다. 업데이트 타임스탬프입니다.

RetailProductRecognitionConfig

JSON 표현

{
  "productDetectionModel": string,
  "detectionConfidenceThreshold": float,
  "recognitionConfidenceThreshold": float,
  "additionalConfig": { object }
}

필드

productDetectionModel	문자열	필수 입력란입니다. 입력 이미지에서 제품을 감지하는 데 사용할 모델입니다. 지원되는 값은 'builtin/stable' (기본값) 또는 Vertex AI 모델 리소스 이름입니다.
detectionConfidenceThreshold	float	선택사항입니다. 감지 결과를 필터링하는 신뢰도 기준점입니다. 설정하지 않으면 시스템 기본값이 사용됩니다.
recognitionConfidenceThreshold	float	선택사항입니다. 인식 결과를 필터링하는 신뢰도 기준점입니다. 설정하지 않으면 시스템 기본값이 사용됩니다.
additionalConfig	object (Struct format)	선택사항입니다. 제품 인식을 위한 추가 구성입니다.

RetailTagRecognitionConfig

JSON 표현

{
  "tagDetectionModel": string,
  "tagParsingModel": string,
  "detectionConfidenceThreshold": float,
  "parsingConfidenceThreshold": float,
  "additionalConfig": { object }
}

필드

tagDetectionModel	문자열	필수 입력란입니다. 입력 이미지에서 태그를 감지하는 데 사용할 모델입니다. 지원되는 값: Vertex AI 모델 리소스
tagParsingModel	문자열	필수 입력란입니다. 감지된 태그에서 텍스트를 파싱하는 모델입니다. 지원되는 값: Vertex AI 모델 리소스
detectionConfidenceThreshold	float	선택사항입니다. 감지 결과를 필터링하는 신뢰도 기준점입니다. 설정하지 않으면 시스템 기본값이 사용됩니다.
parsingConfidenceThreshold	float	선택사항입니다. 텍스트 파싱 결과를 필터링하는 신뢰도 기준점입니다. 설정하지 않으면 시스템 기본값이 사용됩니다.
additionalConfig	object (Struct format)	선택사항입니다. 태그 인식을 위한 추가 구성입니다.

메서드: projects.locations.retailEndpoints.create

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/retailEndpoints

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

요청 본문

요청 본문에 RetailEndpoint의 인스턴스가 포함됩니다.

응답 본문

성공하면 응답 본문에 새로 생성된 RetailEndpoint 인스턴스가 포함됩니다.

메서드: projects.locations.retailEndpoints.get

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailEndpoints/*}

경로 매개변수


name	문자열	필수 입력란입니다. `RetailEndpoint` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

메서드: projects.locations.retailEndpoints.list

HTTP 요청

GET https://visionai.googleapis.com/v1alpha1/{parent=projects/*/locations/*}/retailEndpoints

경로 매개변수


parent	문자열	필수 입력란입니다. 상위 식별자입니다.

쿼리 매개변수

filter	문자열	선택사항입니다. 요청 결과를 필터링하는 표현식입니다.
pageToken	문자열	선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
pageSize	정수	선택사항입니다. 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
orderBy	문자열	선택사항입니다. 오름차순으로 정렬된 정렬 기준 필드의 쉼표로 구분된 목록입니다. 내림차순으로 표시하려면 필드 이름 뒤에 'desc'를 사용합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현

{
  "retailEndpoints": [
    {
      object (RetailEndpoint)
    }
  ],
  "nextPageToken": string
}

메서드: projects.locations.retailEndpoints.delete

HTTP 요청

DELETE https://visionai.googleapis.com/v1alpha1/{name=projects/*/locations/*/retailEndpoints/*

경로 매개변수


name	문자열	필수 입력란입니다. `RetailEndpoint` 식별자

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

메서드: projects.locations.retailEndpoints.deployRetailProductRecognitionIndex

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{retailEndpoint=projects/*/locations/*/retailEndpoints/*}:deployRetailProductRecognitionIndex

경로 매개변수


retailEndpoint	문자열	필수 입력란입니다. `RetailProductRecognitionIndex`가 배포된 위치에 있는 `RetailEndpoint` 리소스의 리소스 이름입니다.

요청 본문

JSON 표현

{
  "retailProductRecognitionIndex": string,
}

필드


retailProductRecognitionIndex	문자열	필수 입력란입니다. 배포할 `RetailProductRecognitionIndex`의 리소스 이름입니다.

응답 본문

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

메서드: projects.locations.retailEndpoints.undeployRetailProductRecognitionIndex

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{retailEndpoint=projects/*/locations/*/retailEndpoints/*}:undeployRetailProductRecognitionIndex

경로 매개변수


retailEndpoint	문자열	필수 입력란입니다. 배포 해제가 적용될 `RetailEndpoint` 리소스의 리소스 이름입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

메서드: projects.locations.retailEndpoints.batchAnalyze

HTTP 요청

POST https://visionai.googleapis.com/v1alpha1/{retailEndpoint=projects/*/locations/*/retailEndpoints/*}:batchAnalyze

경로 매개변수


retailEndpoint	문자열	필수 입력란입니다. 추론 요청을 처리할 `RetailEndpoint`의 리소스 이름입니다.

요청 본문

JSON 표현

{
  "gcsSource": string,
  "features": { object(Feature) },
  // Union field output can be only one of the following:
  "outputGcsDestination": string,
  "corpus": string,
  // End of list of possible types for union field output.
  "bigqueryTable": string
}

필드

gcsSource	문자열	필수 입력란입니다. 입력 콘텐츠의 Cloud Storage 위치입니다. 입력 위치를 여러 개 제공할 수 있습니다. 모든 입력 위치의 콘텐츠가 한 번에 일괄 처리됩니다. 지원되는 콘텐츠: TXT 파일이며 각 줄은 이미지의 전체 경로입니다. 한 번의 요청으로 최대 5만 개의 이미지를 지원할 수 있습니다.
outputGcsDestination	문자열	선택사항입니다. 출력이 기록될 디렉터리의 Cloud Storage 위치입니다.
corpus	문자열	선택사항입니다. 이미지 창고 자료의 리소스 이름입니다. 아직 지원되지 않습니다.
bigqueryTable	문자열	선택사항입니다. 주석 내보내기를 위한 BigQuery 테이블의 리소스 이름입니다. 'projects//datasets//tables/*' 형식입니다. 설정하면 ML 추론에서 생성된 주석도 지정된 BigQuery 테이블로 내보내집니다. 아직 지원되지 않습니다.
features[]	객체	필수 입력란입니다. 실행할 ML 추론 유형입니다.

특성

JSON 표현

{
  "type": enum(Type),
  "productRecognitionConfig": object(RetailProductRecognitionConfig),
  "tagRecognitionConfig": object(RetailTagRecognitionConfig)
}

필드

유형	enum	필수 입력란입니다. 지형지물 유형입니다.
productRecognitionConfig	객체	선택사항입니다. 제품 인식 기능의 요청별 재정의입니다. 유형이 TYPE_PRODUCT_RECOGNITION으로 설정된 경우에만 유효합니다.
tagRecognitionConfig	객체	선택사항입니다. 태그 인식 기능의 요청별 재정의입니다. 유형이 TYPE_TAG_RECOGNITION으로 설정된 경우에만 유효합니다.

응답 본문

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

유형

GcsSource

JSON 표현

{
  "uris": [string]
}

필드


uris[]	문자열	필수 입력란입니다. Cloud Storage 경로 참조

유형

ENUM 값

TYPE_UNSPECIFIED	기본값입니다. 사용해서는 안 됩니다.
TYPE_PRODUCT_RECOGNITION	제품 인식 배포된 `RetailProductRecognitionIndex`가 있는 `RetailEndpoint`에서 사용해야 합니다.
TYPE_TAG_RECOGNITION	태그 감지 및 파싱 RetailTagRecognitionConfig와 함께 `RetailEndpoint`에서 사용해야 합니다.

RetailProductIoFormat

JSON 표현

{
  "retailProduct": { object(RetailProduct) },
  "retailProductImages": [ { object(RetailProductImage) }]
}

필드

retailProduct	객체	필수 입력란입니다. 가져올 `RetailProduct`
retailProductImages[ ]	객체	선택사항입니다. 가져올 지정된 `RetailProduct`의 `RetailProductImage`입니다.

RetailResourceState

ENUM 값

RETAIL_RESOURCE_STATE_UNSPECIFIED	기본값입니다. 사용해서는 안 됩니다.
RETAIL_RESOURCE_STATE_CREATING	상태 생성
RETAIL_RESOURCE_STATE_CREATED	상태가 생성되었습니다.
RETAIL_RESOURCE_STATE_UPDATING	상태 업데이트 중
RETAIL_RESOURCE_STATE_DELETED	상태 삭제됨
RETAIL_RESOURCE_STATE_ERROR	상태 오류

태그 인식기 가이드 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

태그 인식기 및 제품 인식기 사용 사례

태그 인식기 기능

태그 파싱 스키마

출력 JSON 객체 예시

환경 설정

태그 인식기 사용자 여정

API 사용 - 일괄 추론 분석

엔드포인트 만들기

API 참조

리소스: projects.locations.retailCatalogs

메서드: projects.locations.retailCatalogs.create

메서드: projects.locations.retailCatalogs.get

메서드: projects.locations.retailCatalogs.list

메서드: projects.locations.retailCatalogs.delete

메서드: projects.locations.retailCatalogs.importRetailProducts

리소스: projects.locations.retailProducts

메서드: projects.locations.retailCatalogs.retailProducts.create

메서드: projects.locations.retailCatalogs.retailProducts.get

메서드: projects.locations.retailCatalogs.retailProducts.list

메서드: projects.locations.retailCatalogs.retailProducts.delete

리소스: projects.locations.retailProductImages

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.create

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.get

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.list

메서드: projects.locations.retailCatalogs.retailProducts.retailProductImages.delete

리소스: projects.locations.retailCatalogs.retailProductSets

메서드: projects.locations.retailCatalogs.retailProductSets.create

메서드: projects.locations.retailCatalogs.retailProductSets.get

메서드: projects.locations.retailCatalogs.retailProductSets.list

메서드: projects.locations.retailCatalogs.retailProductSets.delete

메서드: projects.locations.retailCatalogs.retailProductSets.add

메서드: projects.locations.retailCatalogs.retailProductSets.remove

리소스: projects.locations.retailCatalogs.retailProductRecognitionIndexes

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.create

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.get

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.list

메서드: projects.locations.retailCatalogs.retailProductRecognitionIndexes.delete

리소스: projects.locations.retailEndpoints

RetailProductRecognitionConfig

RetailTagRecognitionConfig

메서드: projects.locations.retailEndpoints.create

메서드: projects.locations.retailEndpoints.get

메서드: projects.locations.retailEndpoints.list

메서드: projects.locations.retailEndpoints.delete

메서드: projects.locations.retailEndpoints.deployRetailProductRecognitionIndex

메서드: projects.locations.retailEndpoints.undeployRetailProductRecognitionIndex

메서드: projects.locations.retailEndpoints.batchAnalyze

RetailProductIoFormat

태그 인식기 가이드