이 페이지에는 Google Cloud Shell 편집기에서 실행할 수 있는 작업이 포함된 Google Retail API 대화형 튜토리얼 모음이 나와 있습니다. 이 도구를 사용하면 브라우저에서 직접 클라우드 기반 애플리케이션을 작성, 빌드, 테스트, 실행, 디버깅할 수 있습니다.
개요
학습하고자 하는 내용에 따라 다양한 튜토리얼을 시도해 보세요.
프로젝트를 시작하는 경우 카탈로그 정보 가져오기 튜토리얼을 사용해 보세요. 여기서는 다양한 검색 기능 등을 사용해 볼 수 있도록 제품을 카탈로그로 가져오는 방법을 알아봅니다. 그런 다음 이전 사용자 이벤트 가져오기 튜토리얼을 참조하세요. Retail API는 사용자 이벤트를 사용하여 초기 추천 및 검색결과를 생성합니다. 그런 다음 실시간 사용자 이벤트 기록 튜토리얼을 참조하세요. Retail API는 실시간 사용자 이벤트를 사용하여 관련성 높은 고품질의 결과를 제공합니다.
일반적인 검색 작동 방식에 관심이 있다면 검색 튜토리얼을 사용해 보세요.
제공 구성 및 제어를 사용하여 검색을 구성하는 방법을 알아보려면 다음 튜토리얼을 참조하세요.
카탈로그 정보를 업데이트해야 하는 경우 카탈로그 정보 관리 튜토리얼을 참조하세요.
인벤토리를 업데이트하는 방법을 알아보려면 Retail Search의 인벤토리 업데이트 튜토리얼을 참조하세요.
실시간 사용자 이벤트를 기록하고 보고 삭제하는 방법은 실시간 사용자 이벤트 기록 튜토리얼을 참조하세요.
Recommendations AI를 사용하려는 경우 카탈로그 및 사용자 이벤트 가져오기 및 관리를 위한 튜토리얼을 참조하세요.
카탈로그 정보 가져오기
이 튜토리얼에서는 Retail API로 카탈로그 정보를 가져오고 최신 상태로 유지하는 방법을 설명합니다.
BigQuery에서 카탈로그 데이터 가져오기
이 튜토리얼에서는 BigQuery 테이블을 사용하여 제한 없이 대량의 카탈로그 데이터를 가져오는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
Cloud Storage에서 카탈로그 데이터 가져오기
이 튜토리얼에서는 많은 수의 항목을 카탈로그로 가져오는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
인라인으로 카탈로그 데이터 가져오기
이 튜토리얼에서는 인라인으로 카탈로그에 제품을 가져오는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
카탈로그 정보 관리
이 튜토리얼에서는 Retail API로 카탈로그를 가져온 후 제품 정보를 관리하는 방법을 설명합니다. 카탈로그에서 제품을 읽고 쓰고 삭제할 수 있습니다.
선택한 언어로 Google Cloud Retail API를 호출하는 방법을 알아봅니다.
제품 만들기/가져오기/업데이트/삭제 튜토리얼
이 튜토리얼에서는 다음 작업을 수행하는 Retail API 제품 서비스 메서드를 사용하는 방법을 보여줍니다.
- 제품 만들기
- 제품 가져오기
- 제품 업데이트
- 제품 삭제
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
제품 만들기 튜토리얼
이 튜토리얼에서는 단일 제품을 만드는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
제품 가져오기 튜토리얼
이 튜토리얼에서는 제품 항목을 검색하는 방법을 설명합니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
제품 업데이트 튜토리얼
이 튜토리얼에서는 카탈로그에서 제품을 업데이트하는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
제품 삭제 튜토리얼
이 튜토리얼에서는 카탈로그에서 제품을 삭제하는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
이전 사용자 이벤트 가져오기
이 튜토리얼에서는 이전 이벤트에서 사용자 이벤트 데이터를 일괄적으로 가져오는 방법을 설명합니다. Retail API 모델에는 학습을 위한 사용자 이벤트 데이터가 필요합니다.
Cloud Storage에서 이벤트 가져오기 튜토리얼
이 튜토리얼에서는 Cloud Storage에서 사용자 이벤트를 가져오는 방법을 설명합니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
BigQuery에서 이벤트 가져오기 튜토리얼
이 튜토리얼에서는 BigQuery에서 사용자 이벤트를 가져오는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
이벤트 인라인 가져오기 튜토리얼
이 튜토리얼에서는 사용자 이벤트 데이터를 인라인으로 가져오는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
실시간 사용자 이벤트 기록
이 튜토리얼에서는 실시간 사용자 이벤트를 기록, 조회, 삭제하는 방법을 설명합니다. Retail API는 실시간 사용자 이벤트를 사용하여 추천 및 검색결과를 생성합니다. 유효한 제품 정보로 가능한 한 많은 유형의 사용자 이벤트를 기록하면 결과의 품질이 향상됩니다.
사용자 이벤트 작성 튜토리얼
이 튜토리얼에서는 userEvents.write 메서드를 사용하여 사용자 이벤트를 기록하는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
사용자 이벤트 다시 조인 튜토리얼
이 튜토리얼에서는 userEvents:rejoin 엔드포인트에 POST 요청을 보내 사용자 이벤트를 다시 조인하는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
사용자 이벤트 삭제 튜토리얼
이 튜토리얼에서는 사용자 이벤트를 삭제하는 방법을 설명합니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
검색 튜토리얼
Retail API search() 메서드는 검색어와 다른 매개변수(예: 필터, 속성 또는 order_by)에 따라 카탈로그를 검색하는 데 사용됩니다.
기본적으로 검색 응답에는 관련성에 따라 정렬된 적절한 수의 결과가 포함됩니다.
쿼리 튜토리얼
이 튜토리얼에서는 소매업 서비스에 간단한 검색어를 보내고 응답을 분석하는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
페이지로 나누기 튜토리얼
이 튜토리얼에서는 검색 요청에서 페이지로 나누기를 제어하는 방법을 보여줍니다. 쇼핑객이 매장에서 제품을 검색하면 검색결과를 통해 탐색 환경을 개선할 수 있습니다. 예를 들어 페이지 크기 기능을 사용하여 검색 응답의 항목 수를 제한하거나 오프셋 기능을 사용하여 원하는 페이지로 이동할 수 있습니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
쿼리 확장 튜토리얼
이 튜토리얼에서는 검색어 확장 기능을 사용 설정하는 방법을 보여줍니다. 쇼핑객이 모호하거나 여러 단어로 된 검색구문을 사용하면 빈 응답을 받을 수 있습니다. 쿼리 확장을 켠 후 Retail Search는 요청을 분석하고 파싱된 검색어를 기준으로 확장된 제품 목록을 반환합니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
필터링 튜토리얼
이 튜토리얼에서는 필터링 기능을 설명합니다. 이를 통해 관리자는 사용자 또는 고객의 요구사항에 따라 검색 요청을 미세 조정할 수 있습니다. 단일 필드나 여러 필드별로 필터링하거나 텍스트 필드나 숫자 필드별로 또는 두 필드별로 필터링할 수 있습니다. 표현식 언어를 사용하여 각 필드의 조건자를 생성하거나 논리 연산자를 사용하여 여러 표현식을 결합할 수 있습니다. 예를 들어 구두를 찾고 있는 쇼핑객은 필터를 사용하여 선호하는 브랜드와 색상으로 검색 범위를 좁힐 수 있습니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
순서 지정 튜토리얼
이 튜토리얼에서는 검색 응답에서 항목의 순서를 지정하는 방법을 보여줍니다. 쇼핑객이 사이트에서 제품을 검색하면 Retail Search는 여러 필드로 정렬된 결과를 표시할 수 있습니다. 예를 들어 쇼핑객이 최적의 가격과 할인이 제공되는 드레스를 검색하고 있습니다. 여기서 여러 필드는 가격 및 할인입니다. Retail Search는 쇼핑객에게 가격별로 정렬된 드레스를 보여주고 동일한 가격의 드레스에 대해서는 할인순으로 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
부스팅 튜토리얼
이 튜토리얼에서는 검색결과에서 제품 부스팅의 몇 가지 예시를 보여줍니다. 부스팅을 사용하면 제품에 부스트를 적용하여 검색결과에서 우선순위를 지정하거나 낮출 수 있습니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
리디렉션 제어 튜토리얼
이 튜토리얼에서는 리디렉션 제어를 사용하는 방법을 보여줍니다. 리디렉션 제어를 사용하면 특정 검색어를 사용할 때 사용자를 리디렉션할 수 있는 URL을 지정할 수 있습니다. 예를 들어 사용자가 '지속 가능한 제품'을 요청하는 경우 협업 중인 환경 브랜드가 포함된 페이지로 리디렉션할 수 있습니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
Retail Search의 인벤토리 업데이트
Product 생성, 읽기, 업데이트 및 삭제(CRUD) 메서드는 Product의 속성을 광범위하게 수정하는 데 사용되지만, 다양한 수준의 세부사항으로 인벤토리별 필드를 업데이트하는 데 사용할 수 있는 Product 메서드 세트가 있습니다. 다음 Product 필드는 인벤토리 필드로 간주됩니다.
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
fulfillment 추가 튜토리얼
이 튜토리얼에서는 AddFulfillmentPlaces 메서드를 사용하여 제품 fulfillment 정보를 업데이트하는 방법을 보여줍니다. Retail Search는 이러한 방식으로 제품을 제공하고 주문을 처리할 수 있는 업데이트를 표시할 수 있습니다. 예를 들어 쇼핑객이 매장에서 청바지를 찾고 있지만 재고가 없습니다. 이 매장 또는 다른 매장에 청바지가 다시 입고되면 Retail Search에 업데이트가 표시되고 쇼핑객이 주문을 진행할 수 있습니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
fulfillment 삭제 튜토리얼
이 튜토리얼에서는 [RemoveFulfillmentPlaces][remove-fulfillment-places] 메서드를 사용하여 제품 fulfillment 정보를 업데이트하는 방법을 보여줍니다. Retail Search는 이러한 방식으로 제품을 사용할 수 없고 주문을 처리할 수 없는 업데이트를 표시할 수 있습니다. 예를 들어 쇼핑객이 매장에서 청바지를 찾고 있습니다. 이 매장에서 청바지의 재고가 소진되면 Retail Search에 업데이트가 표시되고 쇼핑객은 주문을 진행할 수 없습니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.
인벤토리 설정 튜토리얼
이 튜토리얼에서는 전체 제품을 업데이트하는 대신 SetInventory 메서드를 사용하여 인벤토리 업데이트를 푸시하는 방법을 보여줍니다.
Cloud Shell 편집기에서 이 태스크의 단계별 안내를 직접 수행하려면 둘러보기를 클릭합니다.