미디어 피드는 TV 시리즈, 영화, 노래, 앨범 등 카탈로그의 미디어 콘텐츠를 나타내는 항목 컬렉션이 포함된 JSON 객체입니다. 온보딩 프로세스의 첫 번째 단계는 피드 개발을 시작하는 것입니다. 파일이 준비되면 Google에서 정기적으로 가져올 수 있도록 지원되는 호스팅 방법 중 하나를 사용하여 피드를 호스팅해야 합니다.
피드 파일 형식 요구사항
피드 파일의 요구사항은 다음과 같습니다.
- 피드 파일은 파일 이름 확장자
.json
을(를) 사용해야 합니다. - 피드 파일을 암호화하지 않습니다.
피드 파일을 UTF-8로 인코딩합니다 (파일 편집기 설정 확인).
피드 파일이 1GB (비압축)보다 큰 경우 파일을 여러 개의 파일로 분할합니다.
항목 유형 (예:
tvseries.json
,tvseasons.json
,tvepisodes.json
,movies.json
)별로 파일을 만드는 것이 좋습니다.- 이러한 파일 중 하나라도 1GB를 초과하면 항목을 여러 파일로 분할합니다 (예:
tvepisodes_01.json
,tvepisodes_02.json
등). - 파일 크기가 1GB 미만이면 한 파일에 포함할 수 있는 항목의 수에 제한이 없습니다.
- 이러한 파일 중 하나라도 1GB를 초과하면 항목을 여러 파일로 분할합니다 (예:
JSON 사양에 따라 파일이 BOM없이 인코딩되었는지 확인합니다. Linux OS에서
hexdump file.json | head -n 1
를 확인하려면 주소 0x00에서BBEF
로 시작하지 않아야 합니다.
피드의 유형
프로덕션 피드
- Google에서 실행할 전체 카탈로그를 나타내는 json 피드 파일 집합을 나타냅니다. 피드를 만드는 방법은 아래 섹션을 참조하세요.
- 이 피드가 Google과 처음 통합될 때 필요한 유일한 피드입니다.
- 이 피드가 Google에 제출되면 여러 차례에 걸쳐 광범위하게 분석 및 반복되어 캡처되는 정보의 양과 정확성, 수집 및 실행 전에 품질이 높은 기준을 달성할 수 있습니다.
스테이징 피드
- 프로덕션 피드를 확장해야 하는 특정 사용 사례가 있습니다. 이러한 시나리오의 몇 가지 예는 다음과 같습니다.
- 이전에 출시되지 않은 새로운 항목 유형을 포함하도록 피드 확장
- 새로운 언어에서 출시할 다수의 새로운 항목/메타데이터를 포함하도록 피드 확장
- 새 플랫폼 유형으로 피드 확장 예를 들어 프로덕션 피드가 Google 검색에서만 출시되어 이제 출시를 Google TV로 확장하려는 경우를 예로 들 수 있습니다.
- 이 경우 스테이징 피드가 필요합니다. 이 피드는 추가 메타데이터(예: 새 플랫폼의 딥 링크, 새 언어용 메타데이터 등)가 있다는 점을 제외하고 프로덕션 피드의 사본입니다.
- 이는 프로덕션 피드와 유사하게 수차례에 걸쳐 광범위하게 분석 및 반복되며, 캡처되는 정보의 양과 정확성을 포함하여 더 높은 품질 기준을 달성할 수 있습니다. 품질 막대가 달성되면 이 피드는 현재 프로덕션 피드를 대체하여 새 프로덕션 피드가 됩니다.
- 이 피드를 사용하면 프로덕션 피드에 영향을 주지 않고 초기 출시를 추가 출시에서 분리하고 필요한 모든 테스트를 수행할 수 있습니다. 이렇게 하면 최종 사용자 환경에 지장을 주지 않습니다.
위의 내용과 관련해 궁금한 점이 있으면 Google 담당자에게 문의하세요.
피드 파일 만들기
피드를 만들 때 다음 권장사항을 따르세요.
-
카탈로그의 모든 콘텐츠가 포함된 피드를 만들기 전에 적은 수의 항목으로만 샘플 피드를 만드는 것이 좋습니다. 피드 작업을 하는 동안 문제가 발생할 수 있습니다. 항목 집합의 크기를 제한하면 이러한 오류와 경고를 더 쉽게 디버그할 수 있습니다.
-
Google에서는 피드가 사양을 준수하도록 보장하는 도구를 제공합니다. 이러한 도구를 사용하여 샘플 피드에서 발견된 모든 오류와 경고를 해결하는 것이 좋습니다.
-
소수의 항목에 적합한 구조로 되어 있는지 확인한 후 전체 카탈로그의 피드를 개발합니다.
샘플 피드 만들기
- 카탈로그에서 대표 항목을 1개 선택하세요. 구조가 비교적 복잡하지만 카탈로그에 있는 항목의 전형적인 항목을 선택합니다.
- 데이터 피드 유효성 검사 도구를 사용해 구문 오류와 필수 속성이 누락되었는지 확인하세요. 자세한 내용은 다음 섹션을 참고하세요.
단일
Movie
항목이 있는 피드의 예{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@context": ["http://schema.org", {"@language": "en"}], "@type": "Movie", "@id": "http://www.example.com/my_favorite_movie", "url": "http://www.example.com/my_favorite_movie", "name": "My Favorite Movie", "potentialAction": { "@type": "WatchAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true", "inLanguage": "en", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform", "http://schema.googleapis.com/GoogleVideoCast" ] }, "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "description": "This is my favorite movie.", "actor": [ { "@type": "Person", "name": "John Doe", "sameAs": "https://en.wikipedia.org/wiki/John_Doe" }, { "@type": "Person", "name": "Jane Doe", "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe" } ], "identifier": [ { "@type": "PropertyValue", "propertyID": "IMDB_ID", "value": "tt0123456" } ] } ] }
샘플 피드 유효성 검사
다음 도구를 사용하면 미디어 피드에 대한 Google의 구조화된 데이터 사양을 사용하여 샘플 피드를 검증할 수 있습니다.
데이터 피드 유효성 검사 도구
데이터 피드 유효성 검사 도구는 한 번에 하나의 항목만 확인할 수 있습니다. 이 도구를 사용하여 카탈로그에서 구조 오류 및 일반적인 콘텐츠 오류가 있는 샘플 항목의 유효성을 검사하세요. 이 도구에 관한 자세한 내용은 여기를 참고하세요.
JSON 스키마 검사 도구
JSON 스키마 검사 도구는 피드의 모든 파일을 확인할 수 있습니다. 일반적인 개발 오류를 피하려면 피드를 개발하는 동안 이 도구를 사용하세요. 이 도구에 관한 자세한 내용은 여기를 참고하세요.
프로덕션 피드 만들기
- 샘플 피드의 모든 오류와 경고가 해결되면 피드를 펼쳐 카탈로그의 모든 항목을 포함합니다.
- 데이터 피드 유효성 검사 도구를 사용하면 한 번에 적은 수의 항목을 검증할 수 있습니다. 도구에 많은 수의 항목을 붙여넣으면 웹브라우저가 중단될 수 있습니다. 피드의 항목 수와 카탈로그의 항목 수를 비교하여 피드에 카탈로그의 모든 항목이 포함되어 있는지 확인합니다.