피드는 Actions Center에 인벤토리 데이터를 제공합니다. 이 일일 보안 파일 전송 프로토콜 (SFTP) 업로드는 모든 판매자, 서비스, 이용 가능 시간대 데이터를 업데이트합니다. 피드에서는 지원하는 판매자, 예약 가능 여부, Google에서 인벤토리를 올바르게 표시하는 데 필요한 특별 기능을 지정합니다. 피드는 설정에서 SSH 키를 제공할 때 구성된 SFTP 보관용 계정에 업로드됩니다.
예약 서버로 이동하기 전에 다음 피드 준비 작업을 완료해야 합니다.
피드를 성공적으로 업로드하면 작업이 완료로 표시되고 녹색으로 바뀝니다. 링크된 문서를 검토하여 각 특정 주요 일정 작업을 완료하세요.
식사 예약 엔드 투 엔드 통합이 제대로 작동하려면 매일 판매자 피드, 서비스 피드, 예약 가능 여부 피드를 자동으로 업로드해야 합니다. 자동 피드 인프라에서 전체 인벤토리를 제공해야 합니다.
피드 유형
식사 예약 엔드투엔드 통합에는 다음 피드와 업로드 빈도가 필요합니다.
| 피드 | 설명 | 빈도 | 샘플 |
|---|---|---|---|
| 판매자 | 판매자를 설명합니다. | 24시간에 한 번 | 판매자 피드 샘플 |
| 서비스 | 판매자의 서비스를 설명합니다. | 24시간에 한 번 | 서비스 피드 샘플 |
| 제공 지역 | 판매자의 서비스에 대해 예약 가능한 시간대를 설명합니다. 최소 30일의 보증이 제공되어야 합니다. 보증 기간을 90일로 연장하려면 작업 센터 문의 양식을 통해 Google 지원팀에 문의하세요. | 24시간에 한 번 | 이용 가능 여부 피드 샘플 |
피드 형식은 프로토콜 버퍼 3 구문으로 설명되지만 해당 JSON 형식에 따라 피드를 업로드할 수 있습니다. JSON 형식의 피드 샘플을 참고하세요. 피드를 JSON 형식으로 업로드하는 것이 좋습니다.
이름 지정 규칙 및 메타데이터
파일 이름
샤딩을 사용하는 경우 업로드하는 피드에는 피드 유형과 개수를 지정하는 고유한 이름이 있어야 합니다. 피드 생성 타임스탬프는 피드 파일 이름의 고유 요구사항을 충족합니다.
구조: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
예: availability_feed_1574117613_001_of_002.json.gz
ID 정의
판매자 또는 ID가 필요한 기타 속성의 ID를 정의할 때는 UID 또는 UUID를 사용하는 것이 좋습니다. 플랫폼에서 ID가 고유하게 유지되는 한 영숫자 솔루션을 직접 제공할 수 있습니다.
메타데이터
피드를 만들 때 generation_timestamp는 데이터베이스에서 데이터를 가져온 시간을 반영해야 합니다. 피드 간에 이 값을 재사용하면 처리 오류가 발생할 수 있습니다.
무작위 또는 반복되지 않는 숫자인 nonce 값은 피드 유형 간에 고유해야 하며 재사용할 수 없습니다. 값은 특정 샤드 피드의 모든 파일에 대해 일치해야 합니다.
피드 파일 크기
샤딩 피드 파일
인벤토리에 따라 피드를 여러 파일로 샤딩하거나 분할해야 할 수 있습니다. 다음과 같은 경우 피드를 샤딩해야 할 수 있습니다.
- 압축된 gzip 피드의 파일 하나가 200MB를 초과합니다.
- 예: 생성된 이용 가능 여부 피드가 1GB입니다. 이 데이터는 5개 이상의 별도 샤드로 샤딩해야 합니다.
- 파트너 인벤토리가 시스템 또는 지역에 분산되어 인벤토리를 조정하기가 어렵습니다.
- 예: 파트너가 별도의 시스템에 있는 미국 및 EU 인벤토리를 보유하고 있습니다.
피드가 두 개의 샤드로 생성될 수 있습니다. 미국용 하나와 EU용 하나가 동일한 nonce와
generation_timestamp를 사용합니다.
- 예: 파트너가 별도의 시스템에 있는 미국 및 EU 인벤토리를 보유하고 있습니다.
피드가 두 개의 샤드로 생성될 수 있습니다. 미국용 하나와 EU용 하나가 동일한 nonce와
자세한 내용은 샤드 피드 파일 튜토리얼 및 권장사항을 참고하세요.
피드는 샤드라고 하는 여러 파일로 구성할 수 있습니다. 피드의 크기를 결정하려면 다음 가이드라인을 참고하세요.
- 추천 피드 샤딩:
- 판매자 피드: 샤드 1개
- 서비스 피드: 샤드 1개
- 이용 가능 여부 피드: 샤드 20개 미만 지정된 금액보다 많은 금액이 필요한 비즈니스 근거가 있는 경우 지원팀에 문의하여 추가 안내를 받으세요.
- 피드 파일의 크기 및 샤딩:
- 압축 후 샤드 파일 크기를 200MB 미만으로 유지합니다. 필요한 경우 여러 샤드를 사용합니다.
- 하나의 샤드로 전송되는 개별 레코드는 이후 피드에서 동일한 샤드로 전송하지 않아도 됩니다.
- 성능을 향상하려면 데이터를 샤드 간에 균등하게 분할하여 모든 샤드 파일의 크기를 비슷하게 만듭니다.
- 필요한 경우 gzip을 사용하여 각 개별 피드 샤드의 일반 텍스트 JSON 피드를 압축합니다.
피드 파일 압축
업로드하기 전에 JSON 또는 PB3 파일을 gzip으로 압축할 수 있습니다. 이렇게 하면 일일 피드의 바이트 크기가 크게 줄어들 수 있습니다.
각 샤드 파일은 gzip으로 압축하고 gzip*.json과 같이 개별적으로 업로드해야 합니다. 압축된 피드 샤드는 .json.gz 또는 .pb3.gz로 끝나야 합니다.
SFTP 보관용 계정에 피드 업로드
판매자, 서비스, 가용성 피드를 생성한 후 SFTP 보관용 계정을 통해 샌드박스 또는 프로덕션 환경에 피드를 업로드할 수 있습니다. 설정에서 SSH 키를 제공하면 SFTP 보관용 계정이 구성됩니다.
Google SFTP 서버는 19321 포트의 sftp://partnerupload.google.com에서 사용할 수 있습니다.
Google은 피드 파일이 SFTP 보관용 계정에 업로드되는 즉시 검토하고 검증합니다. 피드가 여러 파일에 걸쳐 샤딩된 경우 마지막 파일이 업로드된 후 처리합니다. 피드에 오류가 포함된 경우 피드 오류 코드가 포함된 이메일이 전송됩니다. 오류로 인해 정의된 판매자, 서비스 또는 이용 가능 시간이 수집되지 않습니다. 피드가 검증된 후 프런트엔드에 피드가 표시되기까지 최대 24시간이 걸릴 수 있습니다.