콘텐츠의 ID, URL, 이름을 수집합니다.
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
카탈로그의 모든 항목에는 다음 속성이 필요합니다.
@id
: 콘텐츠의 전역 식별자입니다.
url
: 콘텐츠의 표준 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
를 사용하지 마세요.
- 정적
- 통합 리소스 식별자 (URI) 형식
- 콘텐츠의 로컬 식별자 (ID)가 URI 형식이 아닌 경우 이 요구사항을 충족하도록 ID 앞에 도메인을 추가합니다. 예를 들어 콘텐츠의 ID가 1234abc이고 도메인이 https://example.com인 경우
@id
은 https://example.com/1234abc가 될 수 있습니다.
@id
는 작동하는 URL이 아니어도 됩니다. URI 형식만 있으면 됩니다.
@id
에 사용되는 도메인 (예: 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
은 전역적으로 고유해야 합니다.
url
에는 Google에서 크롤링할 수 있는 작동하는 표준 URL이 포함되어야 합니다.
- (듣기 작업만 해당)
url
는 페이월로 차단되지 않은 콘텐츠 설명 페이지를 가리켜야 합니다.
ID, URL, 이름 수집
다음 단계를 따르세요.
- 카탈로그에 있는 콘텐츠의 이름을 수집합니다.
- 콘텐츠의 표준 URL을 식별합니다. 콘텐츠의
url
를 @id
로 사용하는 것이 좋습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],[],[[["All catalog entities must have an `@id`, `url`, and `name` property for identification and discoverability."],["The `@id` should be a globally unique, static URI, preferably the same as the `url`."],["The `url` must be a working canonical URL for Google to crawl and reconcile content effectively, pointing to a public content description page for Listen Actions."],["You need to collect and provide the `name`, `url` (recommended for `@id`), and canonical `url` for each entity in your catalog."]]],["Entities require `@id`, `url`, and `name` properties. `@id` must be a globally unique, static URI, which can be a prepended domain to a local ID. `url` must be a globally unique, working canonical URL, crawlable by Google. It's recommended to use the `url` as the `@id` because it satisfies the identifier requirements. The process involves collecting content names and identifying their canonical URLs.\n"]]