이 섹션에서는 액션 센터와 통합하는 3가지 주요 요소에 대해 자세히 설명합니다. 토탈 가이드에 설명된 단계에서 각 요소가 사용됩니다.
피드
피드는 인벤토리 데이터를 액션 센터로 전송하는 데 사용되는 JSON 또는 pb3 형식의 파일입니다. 피드를 사용하면 SFTP 업로드를 통해 모든 데이터를 한 번에 제출하여 판매자, 서비스, 이용 가능 시간대를 업데이트할 수 있습니다.
Maps Booking API
Maps Booking API를 사용하면 피드 제출 시기 사이의 기간에 액션 센터 시스템의 객체를 업데이트하여 정보를 최신 상태로 유지할 수 있습니다. 또한 API를 사용하면 Google 예약 엔드투엔드 통합을 통해 이루어진 예약을 취소할 수 있습니다.
실시간 업데이트는 REST 호출을 사용하여 구현됩니다.
예약 서버
Actions Center 엔드 투 엔드 통합이 판매자를 대신하여 예약을 만들도록 하려면 예약 서버를 설정해야 합니다.
REST API
v3 버전은 API의 최신 버전이며 REST 기반 인터페이스를 지원합니다. 모든 새 통합에서 v3 API를 사용해야 합니다.
이 섹션에서는 인벤토리 데이터를 액션 센터로 전송하는 데 사용되는 피드 파일을 지정합니다. 피드의 콘텐츠는 제공하는 서비스, 사용 가능한 서비스, 서비스가 제공되는 시기를 정의합니다.
참조 및 샘플 섹션을 확인하여 이러한 피드를 YouTube와 공유하는 방법을 알아보세요.
인벤토리 피드의 구조는 Google 지도 예약 API에 의해 정의됩니다.
모든 통합에서 다음 피드는 필수입니다.
- 판매자 피드: 판매자를 설명하는 데이터가 포함됩니다.
또한 다음 2개의 피드는 엔드투엔드 통합에 필수입니다.
이러한 피드에는 필수 필드와 선택 필드가 있습니다. 선택사항으로 표시된 필드는 비워 두면 피드에서 제외됩니다.
피드 양식은 프로토콜 버퍼 3 구문으로 설명됩니다. 피드 파일을 pb3 형식 또는 파생된 JSON 형식의 프로토콜 버퍼 데이터 바이너리 직렬화로 업로드할 수 있습니다. 피드는 JSON 형식으로 업로드하는 것이 좋습니다.
업로드하기 전에 gzip을 사용하여 피드를 압축하는 것이 좋습니다.
이 가이드는 Actions Center 프로토콜 버퍼에만 적용됩니다. 프로토콜 버퍼를 사용하여 pb3 파일을 생성하는 방법에 관한 일반적인 정보는 자바 예를 참고하세요.