이 페이지는 Cloud Translation API를 통해 번역되었습니다.

피드 만들기

미디어 피드는 TV 시리즈, 영화, 노래, 앨범 등 카탈로그의 미디어 콘텐츠를 나타내는 항목 컬렉션이 포함된 JSON 객체입니다. 온보딩 프로세스의 첫 번째 단계는 피드 개발을 시작하는 것입니다. 파일이 준비되면 Google에서 정기적으로 가져올 수 있도록 지원되는 호스팅 방법 중 하나를 사용하여 피드를 호스팅해야 합니다.

피드 파일 형식 요구사항

피드 파일의 요구사항은 다음과 같습니다.

피드 파일은 파일 이름 확장자 .json을(를) 사용해야 합니다.
피드 파일을 암호화하지 않습니다.
피드 파일을 UTF-8로 인코딩합니다 (파일 편집기 설정 확인).
피드 파일이 1GB (비압축)보다 큰 경우 파일을 여러 개의 파일로 분할합니다.
항목 유형 (예: tvseries.json, tvseasons.json, tvepisodes.json, movies.json)별로 파일을 만드는 것이 좋습니다.
- 이러한 파일 중 하나라도 1GB를 초과하면 항목을 여러 파일로 분할합니다 (예: tvepisodes_01.json, tvepisodes_02.json 등).
- 파일 크기가 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 스키마 검사 도구는 피드의 모든 파일을 확인할 수 있습니다. 일반적인 개발 오류를 피하려면 피드를 개발하는 동안 이 도구를 사용하세요. 이 도구에 관한 자세한 내용은 여기를 참고하세요.

프로덕션 피드 만들기

샘플 피드의 모든 오류와 경고가 해결되면 피드를 펼쳐 카탈로그의 모든 항목을 포함합니다.
데이터 피드 유효성 검사 도구를 사용하면 한 번에 적은 수의 항목을 검증할 수 있습니다. 도구에 많은 수의 항목을 붙여넣으면 웹브라우저가 중단될 수 있습니다. 피드의 항목 수와 카탈로그의 항목 수를 비교하여 피드에 카탈로그의 모든 항목이 포함되어 있는지 확인합니다.

가격 확인

피드 호스팅