데이터 피드를 통해 식당, 서비스, 메뉴를 엔드 투 엔드 주문에서 제공하는 경우
이 문서에서는 샌드박스 및 프로덕션 인벤토리를 호스팅하고 일괄 수집을 사용하는 방법을 설명합니다. 을 사용하여 엔드 투 엔드 주문에서 인벤토리를 업데이트하세요.
데이터 피드 환경
통합 개발에 사용할 수 있는 데이터 피드 환경은 세 가지입니다.
| 피드 환경 | 설명 | 오프라인 저장소로 |
|---|---|---|
| 샌드박스 | 피드 개발을 위한 테스트 환경입니다. | 필수 |
| 프로덕션 | 실행하려는 인벤토리의 프로덕션 환경입니다. | 필수 |
데이터 피드 호스팅
엔드 투 엔드 주문을 통해 샌드박스 및 프로덕션 데이터 피드를 배치별로 처리하려면 데이터를 수집하려면 Google Cloud Storage, Amazon S3 또는 HTTPS에서 있습니다.
샌드박스 및 프로덕션 환경을 위한 데이터 피드를 호스팅하는 것이 좋습니다. 별도로 관리할 수 있습니다 이 방식을 사용하면 샌드박스 피드 환경에서 개발과 테스트를 수행할 수 있습니다. 체크하는 방법을 알아보겠습니다
예를 들어 Google Cloud Storage를 호스팅 옵션으로 사용하는 경우 다음과 같습니다. 경로:
- 샌드박스 피드:
gs://foorestaurant-google-feed-sandbox/ - 제작 피드:
gs://foorestaurant-google-feed-prod/
인벤토리를 호스팅하려면 다음 단계를 따르세요.
- 데이터 피드 파일을 생성합니다.
- 호스팅 솔루션을 선택합니다.
- 데이터 피드를 호스팅합니다.
- 데이터 피드 파일은 정기적으로 업데이트해야 합니다. 프로덕션 데이터 피드를 업데이트해야 합니다. 매일
인벤토리 피드를 만드는 방법에 관한 자세한 내용은
Restaurant님,
Service님,
및 Menu
엔터티뿐 아니라
데이터 피드 만들기
섹션으로 이동합니다.
데이터 피드 파일 가이드라인
각 파일은 여러 항목을 포함할 수 있으며 200MB를 초과할 수 없습니다. 최상위 수준
항목 Restaurant, Service, Menu와
하위 항목은 모두 합쳐 4MB를 초과할 수 없습니다.
호스팅 솔루션 선택
다음 표에는 데이터 피드를 호스팅하는 옵션과 해당 호스트가 엔드 투 엔드 순서 지정:
| Amazon S3 | Google Cloud Storage | 사이트맵이 있는 HTTPS | |
|---|---|---|---|
| 사용자 인증 정보 및 액세스 |
Google에 다음 정보를 제공합니다.
S3 버킷에는 다음 정보가 포함되어야 합니다.
|
Google에 프로덕션 및 샌드박스 버킷 디렉터리 및
Google 컨설턴트가 제공한 서비스 계정을 Google Cloud 콘솔의 리더로 추가합니다. Cloud Storage 버킷입니다 Google Cloud Storage (GCS)의 액세스를 제어하는 방법에 대한 자세한 내용은 다음을 참조하세요. Google은 Cloud Platform Console: 버킷 권한 설정 GCS 버킷에는 다음 정보가 포함되어야 합니다.
|
Google에 다음 정보를 제공합니다.
|
| Google에서 가져와야 하는 파일을 파악하는 방법 | 버킷에 있는 모든 파일의 디렉터리 목록입니다. | 버킷에 있는 모든 파일의 디렉터리 목록입니다. | 사이트맵에 나열된 파일의 개별 URL |
| Google에서 파일을 가져올 준비가 되었는지 파악하는 방법 | 데이터 피드 생성을 마친 후 marker.txt 파일을 업데이트합니다.
가장 최근의 타임스탬프로 교체합니다 |
데이터 피드 생성을 마친 후 marker.txt 파일을 업데이트합니다.
가장 최근의 타임스탬프로 교체합니다 |
데이터 피드 생성을 완료한 후 응답 헤더를 업데이트하세요.
최신 타임스탬프가 적용된 sitemap.xml의 last-modified입니다. |
| 파일 한도 |
최대 파일 수: 100,000개. Amazon S3 버킷에 있는 파일의 총 개수가 100,000개 미만이어야 합니다. |
최대 파일 수: 100,000개. Google Cloud Storage 버킷에 있는 파일의 총 개수가 100,000개 미만이어야 합니다. |
최대 파일 수: 100,000개. 사이트맵 XML 파일 내 파일 경로 수는 100,000개 미만이어야 합니다. |
일괄 수집을 위해 데이터 피드 연결
피드를 호스팅한 후 작업 센터에서 피드에 연결해야 합니다. 이 프로덕션 피드의 초기 구성은 온보딩 태스크 페이지에서 수행됩니다. 나중에 프로덕션 및 샌드박스 피드 구성은> 관리 역할로 할당될 수 있습니다 샌드박스 환경은 개발 및 테스트 목적으로 사용되지만 프로덕션 피드가 사용자에게 표시됩니다
Amazon S3를 사용하여 데이터 피드를 호스팅하는 경우
- 작업 센터에서 구성 >으로 이동합니다. 피드를 선택합니다.
-
수정을 클릭하고 피드 업데이트 양식을 작성합니다.
- 피드 전송 방법: Amazon S3로 설정합니다.
- 마커 파일:
marker.txt파일의 URL을 제공합니다. - 데이터 파일: 데이터 피드가 포함된 S3 버킷의 URL을 제공합니다.
- 액세스 ID: S3에서 읽을 권한이 있는 IAM 액세스 키 ID를 입력합니다. 리소스를 배포합니다
- 액세스 키: S3에서 읽을 권한이 있는 IAM 보안 비밀 액세스 키를 입력합니다. 리소스를 배포합니다
- 제출을 클릭합니다.
- 1~2시간 후에 일괄 처리가 피드 파일을 가져오는지 확인합니다.
Google Cloud Storage로 데이터 피드를 호스팅하는 경우
- 작업 센터에서 구성 >으로 이동합니다. 피드를 선택합니다.
-
수정을 클릭하고 피드 업데이트 양식을 작성합니다.
- 피드 게재 방법: Google Cloud Storage로 설정합니다.
- 마커 파일:
marker.txt파일의 URL을 제공합니다. - 데이터 파일: 데이터 피드가 포함된 GCS 버킷의 URL을 제공합니다.
- 제출을 클릭합니다.
- GCS 버킷에 액세스할 수 있도록 서비스 계정이 생성됩니다. 계정 이름은 다음에서 확인할 수 있습니다. 온보딩 작업 후 구성 > 피드 완료됩니다. 이 서비스 계정에는 '스토리지 기존 객체 리더' 역할이 필요합니다. 이 역할은 Google Cloud 콘솔의 IAM 페이지에서 서비스 계정에 권한을 부여해야 합니다.
- 1~2시간 후에 일괄 처리가 피드 파일을 가져오는지 확인합니다.
HTTPS를 사용하여 데이터 피드를 호스팅하는 경우
- 작업 센터에서 구성 >으로 이동합니다. 피드를 선택합니다.
-
수정을 클릭하고 피드 업데이트 양식을 작성합니다.
- 피드 전송 방법: HTTPS로 설정합니다.
- 사이트맵 파일:
sitemap.xml파일의 URL을 제공합니다. - 사용자 이름: HTTPS 서버에 액세스할 때 사용할 사용자 이름 사용자 인증 정보를 입력합니다.
- 비밀번호: HTTPS 서버에 액세스할 때 사용할 비밀번호를 입력합니다.
- 제출을 클릭합니다.
- 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에서 오래된 파일을 가져올 수 있습니다