카탈로그의 콘텐츠 항목에는 일반적으로 다음 속성이 필요합니다.
@id: 항목의 전역 식별자입니다.url: 콘텐츠의 표준 URL입니다.BroadcastEvent,SportsEvent또는 채널 라인업 항목(TelevisionChannel및CableOrSatelliteService)에url를 사용하지 마세요.name: 콘텐츠의 이름입니다.
@id, url, name의 예:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
식별자
식별자(@id)는 다음 요구사항을 충족해야 합니다.
- 카탈로그 전체에서 전역적으로 고유함
- 예를 들어
TVSeries와TVSeason에 동일한@id를 사용하지 마세요.
- 예를 들어
- 정적
- 나중에
@id을(를) 변경할 수 없습니다.
- 나중에
- URI(Unified Resource Identifier) 형식
- 콘텐츠의 로컬 식별자(ID)가 URI 형식이 아닌 경우 이 요구사항을 충족하려면 ID 앞에 도메인을 추가합니다. 예를 들어 콘텐츠의 ID가 1234abc이고 도메인이 https://example.com인 경우
@id는 https://example.com/1234abc가 될 수 있습니다. @id는 작동하는 URL일 필요는 없으며 URI 형식이기만 하면 됩니다.@id에 사용되는 도메인(예: https://example.com)은 조직에서 소유해야 합니다.
- 콘텐츠의 로컬 식별자(ID)가 URI 형식이 아닌 경우 이 요구사항을 충족하려면 ID 앞에 도메인을 추가합니다. 예를 들어 콘텐츠의 ID가 1234abc이고 도메인이 https://example.com인 경우
항목의 url는 식별자로서의 모든 요구사항(전역적으로 고유하고 정적이며 URI 형식)을 충족하므로 항목의 url를 @id로 사용하는 것이 좋습니다.
표준 URL
표준 URL(url)을 사용하면 Google에서 카탈로그의 콘텐츠와 Google 데이터베이스의 콘텐츠를 정확하게 조정할 수 있습니다.
"표준 URL은 Google이 사이트의 중복된 페이지 중 가장 대표적이라고 간주하는 페이지의 URL을 말합니다. 예를 들어 동일한 페이지의 URL이 여러 개 있는 경우(예: example.com?dress=1234 및 example.com/dresses/1234) Google은 하나를 표준 URL로 선택합니다." (출처: 중복 URL 통합)
표준 URL의 요구사항은 다음과 같습니다.
url은 전역적으로 고유해야 합니다.url에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.- (듣기 작업만 해당)
url는 페이월로 차단되지 않은 콘텐츠 설명 페이지를 가리켜야 합니다. - (라이브 TV)
BroadcastEvent항목에url를 포함하지 마세요. TV 및 영화 방송의 경우 기본Movie,TVSeries또는TVEpisode항목에url를 제공합니다. - (스포츠)
SportsEvent항목에url를 포함하지 마세요.SportsEvent.potentialAction를 사용하여 재생 링크를 제공합니다. - (라이브 TV 및 스포츠)
BroadcastEvent.@id가 참조된Movie,TVSeries,TVEpisode또는SportsEvent항목의@id와 다른지 확인합니다.
ID, URL, 이름 수집
다음 단계를 따르세요.
- 카탈로그에 있는 콘텐츠의 이름을 수집합니다.
- 콘텐츠의 표준 URL을 식별합니다. (콘텐츠의
url를@id로 사용하는 것이 좋습니다.)