콘텐츠의 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 계열사의 등록 상표입니다.
[null,null,[],[[["\u003cp\u003eAll catalog entities must have an \u003ccode\u003e@id\u003c/code\u003e, \u003ccode\u003eurl\u003c/code\u003e, and \u003ccode\u003ename\u003c/code\u003e property for identification and discoverability.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e@id\u003c/code\u003e should be a globally unique, static URI, preferably the same as the \u003ccode\u003eurl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eurl\u003c/code\u003e must be a working canonical URL for Google to crawl and reconcile content effectively, pointing to a public content description page for Listen Actions.\u003c/p\u003e\n"],["\u003cp\u003eYou need to collect and provide the \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003eurl\u003c/code\u003e (recommended for \u003ccode\u003e@id\u003c/code\u003e), and canonical \u003ccode\u003eurl\u003c/code\u003e for each entity in your catalog.\u003c/p\u003e\n"]]],["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"],null,["# Collect the ID, URL, and name of your content\n\nAll the entities in your catalog require the following properties:\n\n- `@id`: A global [identifier](#identifier) for the content.\n- `url`: A [canonical URL](#canonical_url) for the content.\n- `name`: The name of the content.\n\nExample of `@id`, `url`, and `name`: \n\n \"@id\": \"http://www.example.com/episode/video/432432432\",\n \"url\": \"http://www.example.com/episode/video/432432432\",\n \"name\": \"My example episode\",\n\nIdentifier\n----------\n\nAn identifier (`@id`) must meet the following requirements:\n\n- Globally unique across your catalog\n - For instance, don't use the same `@id` for a `TVSeries` and a `TVSeason`.\n- Static\n - You cannot change `@id` later.\n- In the form of Unified Resource Identifier (URI)\n - If your content's local identifier (ID) is not in a URI format, prepend your domain to the ID to satisfy this requirement; for example, if your content's ID is *1234abc* and your domain is *https://example.com* , `@id` can be *https://example.com/1234abc.*\n - `@id` does not have to be a working URL; it only needs to be in a URI format.\n - The domain used in `@id` (for example, *https://example.com*) must be owned by your organization.\n\nBecause an entity's `url` meets all the requirements as an identifier (that is, globally unique, static, and in the form of a URI), we recommend you use an entity's `url` as `@id`.\n\nCanonical URL\n-------------\n\nA canonical URL (`url`) helps Google accurately reconcile the content in your catalog with the content in Google's databases.\n\n\"A canonical URL is the URL of the page that Google thinks is most representative from a set of duplicate pages on your site. For example, if you have URLs for the same page (for example: *example.com?dress=1234* and *example.com/dresses/1234* ), Google chooses one as canonical.\" (Source: [Consolidate duplicate URLs](https://support.google.com/webmasters/answer/139066))\n\nThe following are the requirements for the canonical URL:\n\n- `url` must be globally unique.\n- `url` must contain a working canonical URL that Google can crawl.\n- (Listen Actions only) `url` needs to point to a content description page that is not blocked by a paywall.\n\nCollect the ID, URL, and name\n-----------------------------\n\nDo the following:\n\n1. Gather the names of the content in your catalog.\n2. Identify the canonical URLs of the content. (We recommend you use the content's `url` as its `@id`.)"]]
