Activities

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

روش‌ها

این API از روش‌های زیر برای منابع activities پشتیبانی می‌کند:

list
لیستی از رویدادهای فعالیت کانال را که با معیارهای درخواست مطابقت دارند، برمی‌گرداند. برای مثال، می‌توانید رویدادهای مرتبط با یک کانال خاص یا کانال خود کاربر را بازیابی کنید. اکنون آن را امتحان کنید .

نمایش منابع

ساختار JSON زیر فرمت یک منبع activities را نشان می‌دهد:

{
  "kind": "youtube#activity",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "type": string,
    "groupId": string
  },
  "contentDetails": {
    "upload": {
      "videoId": string
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "playlistItem": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      },
      "playlistId": string,
      "playlistItemId": string
    },
    "recommendation": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      },
      "reason": string,
      "seedResourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "social": {
      "type": string,
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "author": string,
      "referenceUrl": string,
      "imageUrl": string
    },
    "channelItem": {
      "resourceId": {
      }
    },
  }
}

خواص

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

خواص
kind string
نوع منبع API را مشخص می‌کند. مقدار آن youtube#activity خواهد بود.
etag etag
برچسب E این منبع.
id string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد فعالیت از آن استفاده می‌کند.
snippet object
شیء snippet شامل جزئیات اولیه در مورد فعالیت، از جمله نوع فعالیت و شناسه گروه آن است.
snippet. publishedAt datetime
تاریخ و زمانی که فعالیت رخ داده است. مقدار در قالب ISO 8601 مشخص شده است.
snippet. channelId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد کانال مرتبط با فعالیت از آن استفاده می‌کند.
snippet. title string
عنوان منبعی که در درجه اول با فعالیت مرتبط است.
snippet. description string
شرح منبعی که در درجه اول با فعالیت مرتبط است.
snippet. thumbnails object
نقشه‌ای از تصاویر کوچک مرتبط با منبعی که در درجه اول با فعالیت مرتبط است. برای هر شیء در نقشه، کلید، نام تصویر کوچک است و مقدار، شیء‌ای است که شامل اطلاعات دیگری در مورد تصویر کوچک است.
snippet.thumbnails. (key) object
مقادیر کلید معتبر عبارتند از:
  • default - تصویر کوچک پیش‌فرض. تصویر کوچک پیش‌فرض برای یک ویدیو - یا منبعی که به یک ویدیو اشاره دارد، مانند یک آیتم لیست پخش یا نتیجه جستجو - ۱۲۰ پیکسل عرض و ۹۰ پیکسل ارتفاع دارد. تصویر کوچک پیش‌فرض برای یک کانال ۸۸ پیکسل عرض و ۸۸ پیکسل ارتفاع دارد.
  • medium ​​- نسخه‌ای با وضوح بالاتر از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر ۳۲۰ پیکسل عرض و ۱۸۰ پیکسل ارتفاع دارد. برای یک کانال، این تصویر ۲۴۰ پیکسل عرض و ۲۴۰ پیکسل ارتفاع دارد.
  • high – یک نسخه با وضوح بالا از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر ۴۸۰ پیکسل عرض و ۳۶۰ پیکسل ارتفاع دارد. برای یک کانال، این تصویر ۸۰۰ پیکسل عرض و ۸۰۰ پیکسل ارتفاع دارد.
  • standard - نسخه‌ای از تصویر کوچک با وضوح حتی بالاتر از تصویر با وضوح high . این تصویر برای برخی از ویدیوها و منابع دیگری که به ویدیوها اشاره دارند، مانند موارد لیست پخش یا نتایج جستجو، در دسترس است. این تصویر ۶۴۰ پیکسل عرض و ۴۸۰ پیکسل ارتفاع دارد.
  • maxres – بالاترین وضوح تصویر بندانگشتی. این اندازه تصویر برای برخی از ویدیوها و منابع دیگری که به ویدیوها اشاره دارند، مانند موارد لیست پخش یا نتایج جستجو، در دسترس است. این تصویر ۱۲۸۰ پیکسل عرض و ۷۲۰ پیکسل ارتفاع دارد.
snippet.thumbnails.(key). url string
آدرس اینترنتی (URL) تصویر.
snippet.thumbnails.(key). width unsigned integer
عرض تصویر.
snippet.thumbnails.(key). height unsigned integer
ارتفاع تصویر.
snippet. channelTitle string
عنوان کانال مربوط به این فعالیت
snippet. type string
نوع فعالیتی که منبع توصیف می‌کند.

مقادیر معتبر برای این ویژگی عبارتند از:
  • channelItem
  • comment – (در حال حاضر برگردانده نشده است)
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • upload
snippet. groupId string
شناسه گروه مرتبط با فعالیت. شناسه گروه، رویدادهای کاربری مرتبط با یک کاربر و منبع را شناسایی می‌کند. برای مثال، اگر کاربری ویدیویی را آپلود کند و همان ویدیو را تماشا کند، ورودی‌های مربوط به آن رویدادها، شناسه گروه یکسانی در فید فعالیت کاربر خواهند داشت. در رابط کاربری خود، می‌توانید با گروه‌بندی رویدادها با مقدار groupId یکسان، از تکرار جلوگیری کنید.
contentDetails object
شیء contentDetails حاوی اطلاعاتی در مورد محتوای مرتبط با فعالیت است. برای مثال، اگر مقدار snippet.type videoRated باشد، محتوای شیء contentDetails ویدیوی امتیازدهی شده را مشخص می‌کند.
contentDetails. upload object
شیء upload شامل اطلاعاتی در مورد ویدیوی آپلود شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type upload باشد.
contentDetails.upload. videoId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیوی آپلود شده استفاده می‌کند.
contentDetails. comment object
شیء comment حاوی اطلاعاتی درباره منبعی است که کامنت دریافت کرده است. این ویژگی فقط در صورتی وجود دارد که snippet.type comment باشد.
contentDetails.comment. resourceId object
شیء resourceId حاوی اطلاعاتی است که منبع مرتبط با نظر را مشخص می‌کند.
contentDetails.comment.resourceId. kind string
نوع منبع API.
contentDetails.comment.resourceId. videoId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیوی مرتبط با یک نظر استفاده می‌کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.
contentDetails.comment.resourceId. channelId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد کانال مرتبط با یک نظر استفاده می‌کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind برابر youtube#channel باشد.
contentDetails. playlistItem object
شیء playlistItem حاوی اطلاعاتی درباره یک آیتم جدید در لیست پخش است. این ویژگی فقط در صورتی وجود دارد که snippet.type playlistItem باشد.
contentDetails.playlistItem. resourceId object
شیء resourceId حاوی اطلاعاتی است که منبعی را که به لیست پخش اضافه شده است، شناسایی می‌کند.
contentDetails.playlistItem.resourceId. kind string
نوع منبع API.
contentDetails.playlistItem.resourceId. videoId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیویی که به لیست پخش اضافه شده است، استفاده می‌کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind برابر youtube#video باشد.
contentDetails.playlistItem. playlistId string
مقداری که یوتیوب برای شناسایی منحصر به فرد لیست پخش استفاده می‌کند.
contentDetails.playlistItem. playlistItemId string
مقداری که یوتیوب برای شناسایی منحصر به فرد آیتم در لیست پخش استفاده می‌کند.
contentDetails. recommendation object
شیء recommendation ) حاوی اطلاعاتی در مورد یک منبع توصیه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type recommendation باشد.
contentDetails.recommendation. resourceId object
شیء resourceId حاوی اطلاعاتی است که منبع پیشنهادی را مشخص می‌کند.
contentDetails.recommendation.resourceId. kind string
نوع منبع API.
contentDetails.recommendation.resourceId. videoId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیو استفاده می‌کند، اگر منبع پیشنهادی یک ویدیو باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.
contentDetails.recommendation.resourceId. channelId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد کانال استفاده می‌کند، اگر منبع پیشنهادی یک کانال باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد.
contentDetails.recommendation. reason string
دلیل توصیه منبع به کاربر.

مقادیر معتبر برای این ویژگی عبارتند از:
  • videoWatched
contentDetails.recommendation. seedResourceId object
شیء seedResourceId حاوی اطلاعاتی در مورد منبعی است که باعث توصیه شده است.
contentDetails.recommendation.seedResourceId. kind string
نوع منبع API.
contentDetails.recommendation.seedResourceId. videoId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیو استفاده می‌کند، در صورتی که توصیه توسط یک ویدیوی خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind برابر youtube#video باشد.
contentDetails.recommendation.seedResourceId. channelId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد کانال استفاده می‌کند، در صورتی که توصیه توسط یک کانال خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind برابر youtube#channel باشد.
contentDetails.recommendation.seedResourceId. playlistId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد لیست پخش استفاده می‌کند، در صورتی که توصیه توسط یک لیست پخش خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind برابر youtube#playlist باشد.
contentDetails. social object
شیء social شامل جزئیاتی در مورد یک پست شبکه اجتماعی است. این ویژگی فقط در صورتی وجود دارد که snippet.type social باشد.
contentDetails.social. type string
نام شبکه اجتماعی.

مقادیر معتبر برای این ویژگی عبارتند از:
  • facebook
  • googlePlus
  • twitter
  • unspecified
contentDetails.social. resourceId object
شیء resourceId اطلاعاتی را که منبع مرتبط با یک پست شبکه اجتماعی را مشخص می‌کند، کپسوله‌سازی می‌کند.
contentDetails.social.resourceId. kind string
نوع منبع API.
contentDetails.social.resourceId. videoId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد ویدیوی نمایش داده شده در یک پست شبکه اجتماعی، در صورتی که پست به یک ویدیو اشاره داشته باشد، استفاده می‌کند. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#video باشد.
contentDetails.social.resourceId. channelId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد کانال نمایش داده شده در یک پست شبکه اجتماعی، در صورتی که پست به یک کانال اشاره داشته باشد، استفاده می‌کند. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#channel باشد.
contentDetails.social.resourceId. playlistId string
شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد لیست پخش نمایش داده شده در یک پست شبکه اجتماعی، در صورتی که پست به یک لیست پخش اشاره داشته باشد، استفاده می‌کند. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind برابر youtube#playlist باشد.
contentDetails.social. author string
نویسنده پست شبکه اجتماعی.
contentDetails.social. referenceUrl string
آدرس اینترنتی (URL) پست شبکه اجتماعی.
contentDetails.social. imageUrl string
تصویری از نویسنده‌ی پست.
contentDetails. channelItem object
شیء channelItem شامل جزئیاتی درباره منبعی است که به کانال اضافه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type channelItem باشد.
contentDetails.channelItem. resourceId object
شیء resourceId حاوی اطلاعاتی است که منبعی را که به کانال اضافه شده است، شناسایی می‌کند.