این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

یک فید ایجاد کنید

فید رسانه یک شی JSON است که شامل مجموعه‌ای از موجودیت‌ها است که محتوای رسانه را در کاتالوگ شما نشان می‌دهد، مانند سریال‌های تلویزیونی، فیلم‌ها، آهنگ‌ها، آلبوم‌ها و موارد دیگر. اولین مرحله در فرآیند ورود، شروع به توسعه فیدهای خود است. پس از آماده شدن فایل‌ها، باید فید را با استفاده از یکی از روش‌های میزبانی پشتیبانی شده میزبانی کنید تا Google به طور منظم واکشی کند.

الزامات فرمت فایل خوراک

شرایط زیر برای فایل(های) فید است:

فایل فید باید دارای پسوند نام فایل .json باشد.
فایل فید خود را رمزگذاری نکنید.
فایل فید خود را در UTF-8 رمزگذاری کنید (تنظیمات ویرایشگر فایل خود را بررسی کنید).
اگر فایل فید شما بزرگتر از 1 گیگابایت است (فشرده نشده) فایل را به چند فایل تقسیم کنید.
توصیه می کنیم برای هر نوع موجودیت یک فایل ایجاد کنید (به عنوان مثال tvseries.json ، tvseasons.json ، tvepisodes.json ، movies.json ، و غیره).
- اگر هر یک از این فایل‌ها بیش از 1 گیگابایت باشد، موجودیت‌های آن را به چندین فایل تقسیم کنید (به عنوان مثال tvepisodes_01.json ، tvepisodes_02.json ، و غیره).
- تا زمانی که حجم فایل کمتر از 1 گیگابایت باشد، محدودیتی در مورد تعداد موجودیت هایی که می توانید در یک فایل قرار دهید وجود ندارد.
مطمئن شوید که فایل طبق مشخصات JSON بدون BOM کدگذاری شده است. برای بررسی سیستم عامل لینوکس، hexdump file.json | head -n 1 نباید با BBEF در آدرس 0x00 شروع شود.

انواع خوراک

خوراک تولید

این مجموعه فایل(های) فید json را نشان می دهد که با هم کل کاتالوگ شما را که می خواهید در Google راه اندازی کنید را نشان می دهد. در بخش زیر می توانید نحوه ایجاد فید را بیاموزید.
اگر برای اولین بار با Google ادغام می‌شوید، این تنها خوراکی است که به آن نیاز دارید.
هنگامی که این فید به Google ارسال شد، به طور گسترده تجزیه و تحلیل می‌شود و چند بار تکرار می‌شود تا قبل از دریافت و راه‌اندازی نهایی، به نواری با کیفیت بالاتر بر اساس میزان اطلاعات گرفته‌شده و صحت آن‌ها دست یابد.

خوراک صحنه سازی

موارد استفاده خاصی وجود دارد که نیاز به گسترش خوراک تولید دارد. چند نمونه از این سناریوها عبارتند از:
- گسترش فید برای شامل انواع موجودیت‌های جدید، که قبلاً راه‌اندازی نشده‌اند.
- گسترش فید برای شامل تعداد زیادی نهاد/فراداده جدید برای راه‌اندازی در مناطق جدید.
- گسترش خوراک به انواع پلت فرم جدید. به عنوان مثال، هنگامی که فید تولید فقط در جستجوی Google راه اندازی می شود و اکنون می خواهید راه اندازی را به Google TV گسترش دهید.
در چنین مواردی، خوراک مرحله‌بندی مورد نیاز است. این فید یک کپی از فید تولید است با این تفاوت که دارای ابرداده های اضافی است، به عنوان مثال، پیوندهای عمیق برای یک پلت فرم جدید، ابرداده برای یک منطقه جدید و غیره.
مشابه خوراک تولید، این به طور گسترده تجزیه و تحلیل می شود و چند بار تکرار می شود تا به نوار با کیفیت بالاتر بر اساس مقدار اطلاعات گرفته شده و صحت آن دست یابد. هنگامی که نوار کیفیت به دست آمد، این خوراک جایگزین خوراک تولید فعلی می شود تا به خوراک تولید جدید تبدیل شود.
این فید به ما امکان می‌دهد راه‌اندازی اولیه را از راه‌اندازی‌های اضافی جدا کنیم، همه آزمایش‌های لازم را انجام دهیم، بدون اینکه روی خوراک تولید تأثیر بگذاریم. این تضمین می کند که هیچ اختلالی در تجربه کاربر نهایی ایجاد نشود.

با نماینده Google خود همکاری کنید تا هر گونه سوالی که ممکن است در مورد موارد بالا داشته باشید را روشن کنید.

یک فایل فید ایجاد کنید

هنگام ایجاد فید، بهترین روش‌ها را دنبال کنید:

یک فید نمونه با استفاده از مجموعه کوچکی از موجودیت ها ایجاد کنید
قبل از ساختن فید حاوی تمام محتوای کاتالوگ شما، توصیه می کنیم یک فید نمونه فقط با مجموعه کوچکی از موجودیت ها ایجاد کنید. در حین کار بر روی فید خود، احتمالاً با مشکلاتی مواجه خواهید شد. با محدود کردن اندازه مجموعه موجودیت‌ها، می‌توانید این خطاها و هشدارها را راحت‌تر رفع کنید.
فید نمونه را اعتبار سنجی کنید
ما ابزارهایی را ارائه می دهیم که اطمینان حاصل می کنند که فید شما با مشخصات مطابقت دارد. توصیه می کنیم از این ابزارها برای رفع تمام خطاها و هشدارهای موجود در فید نمونه خود استفاده کنید.
یک خوراک تولید ایجاد کنید
پس از اینکه تأیید کردید که ساختار خوبی برای مجموعه کوچکی از موجودیت های خود دارید، یک فید برای کل کاتالوگ خود ایجاد کنید.

یک فید نمونه ایجاد کنید

یک نهاد نماینده از کاتالوگ خود انتخاب کنید. موجودیتی با ساختار نسبتاً پیچیده انتخاب کنید، اما همچنان برای یک موجودیت در کاتالوگ معمولی است.

از ابزار Data Feed Validation برای بررسی خطاهای نحوی و عدم وجود ویژگی های مورد نیاز استفاده کنید. (برای جزئیات بیشتر به بخش بعدی مراجعه کنید.)

مثالی از فید با یک موجودیت 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 برای فیدهای رسانه در دسترس هستند.

ابزار اعتبار سنجی خوراک داده ها
ابزار Data Feed Validation می تواند یک موجودیت واحد را در یک زمان تایید کند. از این ابزار برای تأیید اعتبار یک موجودیت نمونه از کاتالوگ خود برای خطاهای ساختاری و خطاهای رایج محتوایی استفاده کنید. شما می توانید جزئیات بیشتر در مورد ابزار را در اینجا بیابید.
ابزار اعتبارسنجی طرحواره JSON
ابزار JSON Schema Validation می تواند تمام فایل های موجود در فید را تایید کند. از این ابزار در طول توسعه خوراک استفاده کنید تا از اشتباهات ساختاری رایج جلوگیری کنید. شما می توانید جزئیات بیشتر در مورد ابزار را در اینجا بیابید.

یک خوراک تولید ایجاد کنید

هنگامی که همه خطاها و هشدارهای موجود در فید نمونه برطرف شد، فید را گسترش دهید تا همه موجودیت‌های موجود در کاتالوگ شما را شامل شود.
از ابزار Data Feed Validation مکرراً برای تأیید اعتبار تعداد کمی از موجودیت ها در فید خود در یک زمان استفاده کنید (چسباندن تعداد زیادی از موجودیت ها در ابزار ممکن است مرورگر وب را مسدود کند). با مقایسه تعداد موجودات موجود در فید خود با تعداد موارد موجود در کاتالوگ، تأیید کنید که فید شما شامل همه موجودات موجود در کاتالوگ شما می شود.