2단계: 피드 구현

참조 문서에 따라 피드를 구현합니다. 샌드박스 환경을 사용하면 언제든지 피드를 업로드하고 테스트할 수 있습니다.

피드 만들기

  1. 피드를 생성합니다. 피드를 통해 대부분의 인벤토리 데이터를 Google에 전송합니다. 시작하려면 이벤트 JSON 피드와 JSON 설명자 파일을 만듭니다.

    • Event feed: 이벤트를 설명합니다.
    • Descriptor file: 시트에서 전송할 타임스탬프, 피드 유형, 파일 목록과 같은 피드에 관한 메타데이터를 제공합니다.
  2. 피드를 내보냅니다. 피드 형식은 프로토콜 버퍼 3 구문으로 설명되지만 샘플을 참조하여 JSON 형식을 확인할 수 있습니다. JSON 형식으로 피드를 업로드하는 것이 좋습니다.

  3. SFTP 서버에 피드를 업로드합니다. 피드를 업로드하려면 Google에서 제공한 SFTP 서버 정보설정에서 만든 비공개 키를 사용하세요. Google SFTP 서버는 19321 포트의 sftp://partnerupload.google.com에서 사용할 수 있습니다.

    타임스탬프가 포함된 이름과 같이 고유한 이름으로 파일을 업로드합니다. 고유한 이름은 문제 해결에 도움이 되며 피드 상태를 쿼리할 수 있습니다.

    피드의 크기와 업로드 빈도를 결정하려면 다음 가이드라인을 참고하세요.

    • 피드 파일 및 샤드의 크기:
      • 피드 파일 크기를 200MB 미만으로 유지합니다 (압축 후). gzip를 사용하여 압축합니다.
      • 파일이 200MB를 초과할 수 있는 경우 (압축 후) 피드 파일 샤딩 튜토리얼에 따라 여러 샤드로 분할합니다. 하지만 이 통합만으로는 200MB 한도에 도달할 가능성은 낮습니다.
    • 전체 업데이트 빈도:
      • 전체 이벤트 피드는 하루에 한 번 이상 제공됩니다.

Google에서 피드 평가

피드를 업로드하면 Google에서 피드를 처리하고 피드의 품질과 완전성을 평가합니다. Google은 다음과 같은 요인을 확인합니다.

  • 피드가 사양을 충족함
  • 피드에 모든 필수 입력란이 포함되어 있음
  • 장소 데이터가 Google 지도 위치와 일치함