오프라인 저장소로

데이터 피드를 통해 식당, 서비스, 메뉴를 엔드 투 엔드 주문에서 제공하는 경우

이 문서에서는 샌드박스 및 프로덕션 인벤토리를 호스팅하고 일괄 수집을 사용하는 방법을 설명합니다. 을 사용하여 엔드 투 엔드 주문에서 인벤토리를 업데이트하세요.

데이터 피드 환경

통합 개발에 사용할 수 있는 데이터 피드 환경은 세 가지입니다.

피드 환경 설명 오프라인 저장소로
샌드박스 피드 개발을 위한 테스트 환경입니다. 필수
프로덕션 실행하려는 인벤토리의 프로덕션 환경입니다. 필수

데이터 피드 호스팅

엔드 투 엔드 주문을 통해 샌드박스 및 프로덕션 데이터 피드를 배치별로 처리하려면 데이터를 수집하려면 Google Cloud Storage, Amazon S3 또는 HTTPS에서 있습니다.

샌드박스 및 프로덕션 환경을 위한 데이터 피드를 호스팅하는 것이 좋습니다. 별도로 관리할 수 있습니다 이 방식을 사용하면 샌드박스 피드 환경에서 개발과 테스트를 수행할 수 있습니다. 체크하는 방법을 알아보겠습니다

예를 들어 Google Cloud Storage를 호스팅 옵션으로 사용하는 경우 다음과 같습니다. 경로:

  • 샌드박스 피드: gs://foorestaurant-google-feed-sandbox/
  • 제작 피드: gs://foorestaurant-google-feed-prod/

인벤토리를 호스팅하려면 다음 단계를 따르세요.

  1. 데이터 피드 파일을 생성합니다.
  2. 호스팅 솔루션을 선택합니다.
  3. 데이터 피드를 호스팅합니다.
  4. 데이터 피드 파일은 정기적으로 업데이트해야 합니다. 프로덕션 데이터 피드를 업데이트해야 합니다. 매일

인벤토리 피드를 만드는 방법에 관한 자세한 내용은 Restaurant님, Service님, 및 Menu 엔터티뿐 아니라 데이터 피드 만들기 섹션으로 이동합니다.

데이터 피드 파일 가이드라인

각 파일은 여러 항목을 포함할 수 있으며 200MB를 초과할 수 없습니다. 최상위 수준 항목 Restaurant, Service, Menu와 하위 항목은 모두 합쳐 4MB를 초과할 수 없습니다.

호스팅 솔루션 선택

다음 표에는 데이터 피드를 호스팅하는 옵션과 해당 호스트가 엔드 투 엔드 순서 지정:

Amazon S3 Google Cloud Storage 사이트맵이 있는 HTTPS
사용자 인증 정보 및 액세스

Google에 다음 정보를 제공합니다.

  • 액세스 키 ID
  • 보안 비밀 액세스 키
  • 프로덕션 및 샌드박스 S3 디렉터리 및 marker.txt의 경로 파일에서 참조됩니다. 경로는 s3://로 시작해야 합니다.

S3 버킷에는 다음 정보가 포함되어야 합니다.

  • 인벤토리의 피드 파일입니다.
  • marker.txt: 가져오기에 사용되는 타임스탬프가 포함되어 있습니다.

marker.txt 파일 예: 2018-12-03T08:30:42.694Z

Google에 프로덕션 및 샌드박스 버킷 디렉터리 및 marker.txt 파일. 경로는 gs://로 시작해야 합니다.

Google 컨설턴트가 제공한 서비스 계정을 Google Cloud 콘솔의 리더로 추가합니다. Cloud Storage 버킷입니다

Google Cloud Storage (GCS)의 액세스를 제어하는 방법에 대한 자세한 내용은 다음을 참조하세요. Google은 Cloud Platform Console: 버킷 권한 설정

GCS 버킷에는 다음 정보가 포함되어야 합니다.

  • 인벤토리의 피드 파일입니다.
  • marker.txt: 가져오기에 사용되는 타임스탬프가 포함되어 있습니다.

marker.txt 파일 예: 2018-12-03T08:30:42.694Z

Google에 다음 정보를 제공합니다.

  • 기본 인증에 대한 사용자 인증 정보
  • 프로덕션 및 샌드박스 사이트맵 경로입니다. 경로는 https://로 시작해야 합니다.
  • 프로토콜: HTTP가 아닌 HTTPS를 통해 피드 파일을 사용할 수 있도록 해야 합니다.
  • 보안: 호스팅된 피드 파일을 보호하는 것이 좋습니다. 기본 인증.
Google에서 가져와야 하는 파일을 파악하는 방법 버킷에 있는 모든 파일의 디렉터리 목록입니다. 버킷에 있는 모든 파일의 디렉터리 목록입니다. 사이트맵에 나열된 파일의 개별 URL
Google에서 파일을 가져올 준비가 되었는지 파악하는 방법 데이터 피드 생성을 마친 후 marker.txt 파일을 업데이트합니다. 가장 최근의 타임스탬프로 교체합니다 데이터 피드 생성을 마친 후 marker.txt 파일을 업데이트합니다. 가장 최근의 타임스탬프로 교체합니다 데이터 피드 생성을 완료한 후 응답 헤더를 업데이트하세요. 최신 타임스탬프가 적용된 sitemap.xmllast-modified입니다.
파일 한도

최대 파일 수: 100,000개.

Amazon S3 버킷에 있는 파일의 총 개수가 100,000개 미만이어야 합니다.

최대 파일 수: 100,000개.

Google Cloud Storage 버킷에 있는 파일의 총 개수가 100,000개 미만이어야 합니다.

최대 파일 수: 100,000개.

사이트맵 XML 파일 내 파일 경로 수는 100,000개 미만이어야 합니다.

일괄 수집을 위해 데이터 피드 연결

피드를 호스팅한 후 작업 센터에서 피드에 연결해야 합니다. 이 프로덕션 피드의 초기 구성은 온보딩 태스크 페이지에서 수행됩니다. 나중에 프로덕션 및 샌드박스 피드 구성은> 관리 역할로 할당될 수 있습니다 샌드박스 환경은 개발 및 테스트 목적으로 사용되지만 프로덕션 피드가 사용자에게 표시됩니다

Amazon S3를 사용하여 데이터 피드를 호스팅하는 경우

  1. 작업 센터에서 구성 >으로 이동합니다. 피드를 선택합니다.
  2. 수정을 클릭하고 피드 업데이트 양식을 작성합니다.

    • 피드 전송 방법: Amazon S3로 설정합니다.
    • 마커 파일: marker.txt 파일의 URL을 제공합니다.
    • 데이터 파일: 데이터 피드가 포함된 S3 버킷의 URL을 제공합니다.
    • 액세스 ID: S3에서 읽을 권한이 있는 IAM 액세스 키 ID를 입력합니다. 리소스를 배포합니다
    • 액세스 키: S3에서 읽을 권한이 있는 IAM 보안 비밀 액세스 키를 입력합니다. 리소스를 배포합니다
  3. 제출을 클릭합니다.
  4. 1~2시간 후에 일괄 처리가 피드 파일을 가져오는지 확인합니다.

Google Cloud Storage로 데이터 피드를 호스팅하는 경우

  1. 작업 센터에서 구성 >으로 이동합니다. 피드를 선택합니다.
  2. 수정을 클릭하고 피드 업데이트 양식을 작성합니다.

    • 피드 게재 방법: Google Cloud Storage로 설정합니다.
    • 마커 파일: marker.txt 파일의 URL을 제공합니다.
    • 데이터 파일: 데이터 피드가 포함된 GCS 버킷의 URL을 제공합니다.
  3. 제출을 클릭합니다.
  4. GCS 버킷에 액세스할 수 있도록 서비스 계정이 생성됩니다. 계정 이름은 다음에서 확인할 수 있습니다. 온보딩 작업 후 구성 > 피드 완료됩니다. 이 서비스 계정에는 '스토리지 기존 객체 리더' 역할이 필요합니다. 이 역할은 Google Cloud 콘솔의 IAM 페이지에서 서비스 계정에 권한을 부여해야 합니다.
  5. 1~2시간 후에 일괄 처리가 피드 파일을 가져오는지 확인합니다.

HTTPS를 사용하여 데이터 피드를 호스팅하는 경우

  1. 작업 센터에서 구성 >으로 이동합니다. 피드를 선택합니다.
  2. 수정을 클릭하고 피드 업데이트 양식을 작성합니다.

    • 피드 전송 방법: HTTPS로 설정합니다.
    • 사이트맵 파일: sitemap.xml 파일의 URL을 제공합니다.
    • 사용자 이름: HTTPS 서버에 액세스할 때 사용할 사용자 이름 사용자 인증 정보를 입력합니다.
    • 비밀번호: HTTPS 서버에 액세스할 때 사용할 비밀번호를 입력합니다.
  3. 제출을 클릭합니다.
  4. 1~2시간 후에 일괄 처리가 피드 파일을 가져오는지 확인합니다.

경로 예

다음 표에는 각 호스팅 옵션의 경로 예시가 나와 있습니다.

Amazon S3 Google Cloud Storage 사이트맵이 있는 HTTPS
경로 s3://foorestaurant-google-feed-sandbox/ gs://foorestaurant-google-feed-sandbox/ https://sandbox-foorestaurant.com/sitemap.xml
마커 파일 s3://foorestaurant-google-feed-sandbox/marker.txt gs://foorestaurant-google-feed-sandbox/marker.txt 해당 사항 없음

HTTPS 호스팅용 사이트맵

사이트맵을 정의할 때 다음 가이드라인을 따르세요.

  • 사이트맵의 링크는 파일 자체를 가리켜야 합니다.
  • 사이트맵에 내 도메인 이름 대신 클라우드 제공업체에 대한 참조가 포함된 경우 URL의 시작 부분(예: https://www.yourcloudprovider.com/your_id)이 안정적이고 일괄 처리 작업에 고유합니다
  • 부분적인 데이터를 업로드하는 경우와 같이, 부분적인 사이트맵은 업로드하지 않도록 주의하세요. 행동 Google에서 사이트맵에 있는 파일만 처리하며 이로 인해 인벤토리가 피드 처리가 차단될 수 있습니다.
  • 사이트맵에서 참조된 파일의 경로를 변경하지 않아야 합니다. 예를 들어 사이트맵에 https://www.yourcloudprovider.com/your_id/10000.json 참조 포함 오늘 이후 https://www.yourcloudprovider.com/your_id/20000.json 참조 내일입니다.
사이트맵 예

다음은 데이터 피드 파일을 게재하는 sitemap.xml 파일의 예입니다.

예 1: 판매자별로 그룹화된 항목 (권장)

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

예시 2: 유형별로 그룹화된 항목

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

데이터 피드 업데이트

데이터 피드가 연결된 후 Google은 1시간마다 한 번씩 업데이트를 확인하지만 marker.txt 또는 sitemap.xml 파일이 수정된 경우 모든 데이터 피드 수정됨 오래된 인벤토리를 방지하기 위해 데이터 피드를 하루에 한 번 업데이트해야 합니다.

데이터 피드가 수정되어 일괄 수집할 준비가 되었다고 지정하려면 marker.txt 파일의 last-modified 객체 메타데이터 필드 (GCP 및 S3) 또는 sitemap.xml 파일의 last-modified 응답 헤더에서 호출될 수 있습니다. Google 는 이 값을 사용하여 데이터 피드가 얼마나 최신인지 판단합니다.

일괄 피드가 처리됨에 따라

  • 현재 주문 엔드 투 엔드 인벤토리에 존재하지 않고 오류가 삽입됩니다.
  • 인벤토리에 이미 있고 오류가 없는 항목 이전 버전보다 dateModified 최신 값이 현재 항목 또는 dateModified가 없는 경우에는 피드 처리 시작 시간이 현재 항목보다 최근입니다. 그렇지 않으면 비활성으로 표시됩니다.
  • 이전 피드의 일부였으나 다음 항목에 더 이상 포함되지 않는 항목 파일이 없는 경우 처리 중인 일괄 피드가 삭제됩니다. 피드 수준 오류를 수정합니다.

타임스탬프 또는 last-modified 응답 헤더는 모든 데이터가 업데이트된 후에만 업데이트해야 합니다. 피드 파일이 생성되고 업데이트됩니다. 데이터 피드를 업데이트하는 일괄 작업을 실행하도록 제한 하루에 한 번 또는 각 일괄 작업 사이에 3시간 이상의 간격을 두어야 합니다. 그렇지 않은 경우 Google에서 오래된 파일을 가져올 수 있습니다