فایل های داده های ساخت یافته
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فایل‌های داده ساختاریافته، فایل‌های فرمت‌بندی‌شده با مقادیر جداشده با کاما (CSV) هستند که برای بازیابی و مدیریت منابع Display & Video 360 به صورت انبوه استفاده می‌شوند. می توانید با استفاده از رابط Display & Video 360 دانلود و آپلود کنید.
برای مرور کلی از قالب و تعاریف ستون، به مستندات فایل های داده های ساخت یافته مراجعه کنید.
چگونه کار می کند؟
فایل‌های داده ساختاریافته، فایل‌های CSV هستند که شامل ردیف بالایی از سرصفحه‌های ستون و ردیف‌های بعدی منابع و تنظیمات آنها هستند. برای مدیریت تنظیمات منابع به صورت انبوه، می‌توانید فایل‌های داده ساختاریافته را دانلود، اصلاح و آپلود کنید. یک فایل واحد از منابع یک نوع واحد تشکیل شده است. هر نوع منبع پشتیبانی شده فرمت فایل خاص خود را دارد که ستون ها و انواع داده های آنها را تعریف می کند.
از آنجایی که فایل‌های CSV فایل‌های متنی هستند، می‌توانید فایل‌های داده ساختاریافته را به صورت دستی در Google Sheets یا سایر نرم‌افزارهای ویرایش متن ویرایش کنید.
فرمت های Structured Data Files نسخه بندی شده اند و هر سال حداکثر چهار نسخه منتشر می شود. نسخه های قبلی به طور منظم منسوخ می شوند و معمولاً شش ماه پس از منسوخ شدن غروب می شوند.
چه کاری می تواند انجام دهد؟
از نسخه 6، فایل‌های داده ساختاریافته از مدیریت انواع منابع زیر پشتیبانی می‌کنند:
- پویش
- سفارش درج
- مورد خط
- گروه تبلیغات YouTube
- تبلیغ یوتیوب
- منبع موجودی
- محصول رسانه ای
تیم شما می‌تواند با دانلود، ویرایش، و آپلود فایل‌ها برای به‌روزرسانی منابع موجود یا ایجاد منابع جدید، این منابع را به صورت انبوه با استفاده از فایل‌های داده ساختاریافته مدیریت کند.
برای چه کسی ساخته شده است؟
ادغام با فایل‌های داده ساختاریافته برای تیم‌هایی ایده‌آل است که می‌خواهند مدیریت دستی منابع Display & Video 360 را فراتر از ویژگی‌های موجود مستقیماً در رابط Display & Video 360 بهینه کنند.
تیم‌ها می‌توانند فایل‌ها را به‌صورت آفلاین ویرایش و به اشتراک بگذارند، و فایل‌های داده ساختاریافته را به گزینه‌ای مناسب برای فرآیندهای چند مرحله‌ای تبدیل می‌کنند. علاوه بر این، با توجه به قالب‌بندی استاندارد فایل‌های داده ساختاریافته، تیم‌هایی با منابع مهندسی می‌توانند اسکریپت‌هایی برای بازبینی یا ویرایش فایل‌ها در صورت نیاز بسازند.
از آنجایی که فایل‌های داده ساختاریافته نسخه می‌شوند، باید گهگاه به نسخه جدیدتر مهاجرت کنید.
چه محصولاتی با آن کار می کند؟
فایل‌های داده ساخت‌یافته برای QA به شما امکان می‌دهند تنظیمات منبع Display & Video 360 را در همان ساختار CSV مانند فایل‌های داده ساختاریافته، اما با داده‌های قابل خواندن بیشتر برای انسان مرور کنید. اگر نیاز به بررسی دستی تنظیمات دارید، می‌توانید از این قالب برای بررسی تنظیمات استفاده کنید و سپس SDFهای استاندارد را دانلود، ویرایش و آپلود کنید تا هرگونه به‌روزرسانی را انجام دهید.
Display & Video 360 API را می‌توان برای تولید و دانلود فایل‌های داده ساختاریافته به صورت برنامه‌نویسی استفاده کرد. دانلود خودکار فایل‌های داده‌های ساختاریافته می‌تواند تضمین کند که فایل‌های لازم زمانی که تیم شما آماده استفاده از آنها است، در دسترس هستند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eStructured Data Files (SDFs) are CSV files used for bulk management of Display & Video 360 resources, allowing for download, modification, and upload via the Display & Video 360 interface.\u003c/p\u003e\n"],["\u003cp\u003eSDFs support various resource types like Campaigns, Insertion Orders, Line Items, and more, enabling teams to efficiently manage these resources in bulk.\u003c/p\u003e\n"],["\u003cp\u003eTeams can leverage SDFs to streamline manual management, perform offline editing and sharing, and utilize scripts for automated review and edits.\u003c/p\u003e\n"],["\u003cp\u003eSDFs integrate with tools like Structured Data Files for QA (human-readable reviews) and the Display & Video 360 API (programmatic file generation and download).\u003c/p\u003e\n"],["\u003cp\u003eSDF formats are versioned, requiring occasional migration to newer versions as older ones are deprecated and eventually sunset.\u003c/p\u003e\n"]]],["Structured Data Files (SDFs) are CSV files for bulk management of Display & Video 360 resources, including campaigns, insertion orders, and line items. Users can download, modify, and upload these files via the Display & Video 360 interface to update existing or create new resources. SDFs are versioned, with new releases up to four times annually. Teams can manage files offline, build scripts for editing, and use SDF for QA to review settings before updating standard SDFs. The Display & Video 360 API allows programmatic generation and download of SDFs.\n"],null,["# Structured Data Files are formatted comma-separated values (CSV) files used to\nretrieve and manage Display \\& Video 360 resources in bulk. You can download and\nupload using the Display \\& Video 360 interface.\n\nSee the [Structured Data Files documentation](/display-video/api/structured-data-file/format) for an overview of the\nformat and column definitions.\n\nHow does it work?\n-----------------\n\nStructured Data Files are CSV files containing a top row of column headers and\nsubsequent rows representing resources and their settings. You can download,\nmodify, and upload Structured Data Files to manage resource settings in bulk. A\nsingle file consists of resources of a single type. Each supported resource type\nhas its own file format defining the columns and their data types.\n\nSince CSV files are text files, you can edit Structured Data Files manually in\nGoogle Sheets or other text editing software.\n\nStructured Data Files formats are versioned, with up to four versions released\nevery year. Earlier versions are regularly deprecated and usually sunset six\nmonths after deprecation.\n\nWhat can it do?\n---------------\n\nAs of v6, Structured Data Files support the management of the following resource\ntypes:\n\n- Campaign\n- Insertion Order\n- Line Item\n- YouTube Ad Group\n- YouTube Ad\n- Inventory Source\n- Media Product\n\nYour team can manage these resources in bulk using Structured Data Files by\ndownloading, editing, and uploading files to update existing resources or create\nnew ones.\n\nWho is it built for?\n--------------------\n\nIntegrating with Structured Data Files is ideal for teams that want to optimize\ntheir manual management of Display \\& Video 360 resources beyond features\navailable directly in Display \\& Video 360 interface.\n\nTeams can edit and share files offline, making Structured Data Files a suitable\nchoice for multi-step processes. In addition, given the standardized formatting\nof Structured Data Files, teams with engineering resources can build scripts to\nreview or edit files as needed.\n\nAs Structured Data Files are versioned, you must occasionally migrate to a newer\nversion.\n\nWhat products work with it?\n---------------------------\n\n[Structured Data Files for QA](/display-video/bulk-tools/tools/sdf-qa) let you review Display \\& Video 360\nresource settings in the same CSV structure as Structured Data Files, but with\nmore human-readable data. If you need to review settings manually, you can use\nthis format to review settings and then download, edit, and upload standard SDFs\nto make any updates.\n\n[Display \\& Video 360 API](/display-video/bulk-tools/tools/dv360-api) can be used to programmatically generate\nand download Structured Data Files. Automating the download of Structured Data\nFiles can guarantee that the necessary files are available when your team is\nready to use them."]]
