이 페이지는 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에서는 피드가 사양을 준수하는지 확인하는 도구를 제공합니다. 이러한 도구를 사용하여 샘플 피드에서 발견된 모든 오류와 경고를 해결하는 것이 좋습니다.
프로덕션 피드 만들기

소수의 항목에 적합한 구조를 갖추었음을 확인한 후 전체 카탈로그의 피드를 개발합니다.

샘플 피드 만들기

카탈로그에서 대표 항목을 하나 선택합니다. 구조가 상당히 복잡하지만 카탈로그의 항목에 일반적인 항목을 선택합니다.

데이터 피드 유효성 검사 도구를 사용하여 구문 오류와 누락된 필수 속성을 확인합니다. (자세한 내용은 다음 섹션을 참고하세요.)

단일 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 스키마 검증 도구를 사용하면 피드의 모든 파일을 검증할 수 있습니다. 피드 개발 중에 이 도구를 사용하여 일반적인 구조적 오류를 방지하세요. 도구에 관한 자세한 내용은 여기를 참고하세요.

프로덕션 피드 만들기

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

가격 확인

피드 호스팅