Activities

یوتیوب ویژگی بولتن کانال را منسوخ کرده است. روش activities.list هنوز بولتن های کانال را بر نمی گرداند و روش activities.insert دیگر پشتیبانی نمی شود. برای جزئیات بیشتر، لطفاً به مرکز راهنمایی YouTube مراجعه کنید.

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

مواد و روش ها

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

list

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

روش activities.insert دیگر پشتیبانی نمی شود.

نمایندگی منابع

ساختار 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
    },
    "like": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "favorite": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "subscription": {
      "resourceId": {
        "kind": 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 Etag این منبع
id	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد فعالیت استفاده می‌کند.
snippet	object شی snippet حاوی جزئیات اساسی در مورد فعالیت است، از جمله نوع فعالیت و شناسه گروه.
snippet. publishedAt	datetime تاریخ و ساعتی که فعالیت انجام شده است. مقدار در قالب ISO 8601 مشخص شده است.
snippet. channelId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانال مرتبط با فعالیت استفاده می‌کند.
snippet. title	string عنوان منبعی که در درجه اول با فعالیت مرتبط است.
snippet. description	string شرح منبعی که در درجه اول با فعالیت مرتبط است.
snippet. thumbnails	object نقشه ای از تصاویر بندانگشتی مرتبط با منبعی که عمدتاً با فعالیت مرتبط است. برای هر شی در نقشه، کلید نام تصویر بند انگشتی است و مقدار آن شیئی است که حاوی اطلاعات دیگری در مورد تصویر کوچک است.
snippet.thumbnails. (key)	object مقادیر کلیدی معتبر عبارتند از: default – تصویر بندانگشتی پیش‌فرض. تصویر کوچک پیش‌فرض یک ویدیو - یا منبعی که به یک ویدیو اشاره می‌کند، مانند آیتم فهرست پخش یا نتیجه جستجو - 120 پیکسل عرض و 90 پیکسل ارتفاع دارد. تصویر کوچک پیش‌فرض برای یک کانال 88 پیکسل عرض و 88 پیکسل ارتفاع است. medium ​​– یک نسخه با وضوح بالاتر از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر 320 پیکسل عرض و 180 پیکسل ارتفاع دارد. برای یک کانال، این تصویر 240 پیکسل عرض و 240 پیکسل ارتفاع دارد. high – یک نسخه با وضوح بالا از تصویر کوچک. برای یک ویدیو (یا منبعی که به یک ویدیو اشاره دارد)، این تصویر 480 پیکسل عرض و 360 پیکسل ارتفاع دارد. برای یک کانال، این تصویر 800 پیکسل عرض و 800 پیکسل ارتفاع دارد. standard - حتی یک نسخه با وضوح بالاتر از تصویر کوچک نسبت به تصویر با وضوح high . این تصویر برای برخی از ویدیوها و سایر منابعی که به ویدیوها اشاره دارند، مانند موارد فهرست پخش یا نتایج جستجو، در دسترس است. این تصویر 640 پیکسل عرض و 480 پیکسل ارتفاع دارد. maxres - بالاترین وضوح تصویر تصویر کوچک. این اندازه تصویر برای برخی از ویدیوها و سایر منابعی که به ویدیوها اشاره دارند، مانند موارد فهرست پخش یا نتایج جستجو، در دسترس است. این تصویر 1280 پیکسل عرض و 720 پیکسل ارتفاع دارد.
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 - (در حال حاضر برگردانده نشده است) favorite like playlistItem promotedItem recommendation social subscription upload bulletin (منسوخ شده)
snippet. groupId	string شناسه گروه مرتبط با فعالیت. شناسه گروهی رویدادهای کاربر را که با همان کاربر و منبع مرتبط هستند شناسایی می کند. به عنوان مثال، اگر کاربر به یک ویدیو امتیاز دهد و همان ویدیو را به عنوان مورد علاقه علامت‌گذاری کند، ورودی‌های آن رویدادها دارای همان شناسه گروه در فید فعالیت کاربر خواهند بود. در رابط کاربری خود، می توانید با گروه بندی رویدادها با همان مقدار groupId از تکرار جلوگیری کنید.
contentDetails	object شی contentDetails حاوی اطلاعاتی در مورد محتوای مرتبط با فعالیت است. برای مثال، اگر مقدار snippet.type videoRated باشد، محتوای شی contentDetails ویدیوی رتبه‌بندی شده را شناسایی می‌کند.
contentDetails. upload	object شیء upload حاوی اطلاعاتی درباره ویدیوی آپلود شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type upload باشد.
contentDetails.upload. videoId	string شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیوی آپلود شده استفاده می کند.
contentDetails. like	object شی like حاوی اطلاعاتی در مورد منبعی است که امتیاز مثبت (مثل) دریافت کرده است. این ویژگی فقط در صورتی وجود دارد که snippet.type like باشد.
contentDetails.like. resourceId	object شی resourceId حاوی اطلاعاتی است که منبع رتبه بندی شده را شناسایی می کند.
contentDetails.like.resourceId. kind	string نوع منبع API.
contentDetails.like.resourceId. videoId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد ویدیو استفاده می‌کند، اگر منبع رتبه‌بندی شده یک ویدیو باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.
contentDetails. favorite	object شی favorite حاوی اطلاعاتی درباره ویدیویی است که به عنوان ویدیوی مورد علاقه علامت گذاری شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type favorite باشد.
contentDetails.favorite. resourceId	object شی resourceId حاوی اطلاعاتی است که منبعی را که به عنوان مورد علاقه علامت گذاری شده است، مشخص می کند.
contentDetails.favorite.resourceId. kind	string نوع منبع API.
contentDetails.favorite.resourceId. videoId	string شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیوی مورد علاقه استفاده می کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد. توجه: روش activities.list در حال حاضر منابعی را برای نظرات جدید برنمی‌گرداند.
contentDetails. comment	object شی comment حاوی اطلاعاتی در مورد منبعی است که نظر دریافت کرده است. این ویژگی فقط در صورتی وجود دارد که snippet.type comment باشد.
contentDetails.comment. resourceId	object شی resourceId حاوی اطلاعاتی است که منبع مرتبط با نظر را شناسایی می کند.
contentDetails.comment.resourceId. kind	string نوع منبع API.
contentDetails.comment.resourceId. videoId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد ویدیوی مرتبط با نظر استفاده می‌کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.
contentDetails.comment.resourceId. channelId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانال مرتبط با نظر استفاده می‌کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد.
contentDetails. subscription	object شیء subscription حاوی اطلاعاتی در مورد کانالی است که کاربر در آن مشترک شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type subscription باشد.
contentDetails.subscription. resourceId	object شی resourceId حاوی اطلاعاتی است که منبعی را که کاربر در آن مشترک شده است شناسایی می کند.
contentDetails.subscription.resourceId. kind	string نوع منبع API.
contentDetails.subscription.resourceId. channelId	string شناسه ای که YouTube برای شناسایی منحصر به فرد کانالی که کاربر در آن مشترک شده است استفاده می کند. این ویژگی فقط در صورتی وجود دارد که 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 شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیویی که به لیست پخش اضافه شده است استفاده می کند. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.
contentDetails.playlistItem. playlistId	string مقداری که YouTube برای شناسایی منحصر به فرد لیست پخش استفاده می کند.
contentDetails.playlistItem. playlistItemId	string مقداری که YouTube برای شناسایی منحصر به فرد مورد در لیست پخش استفاده می کند.
contentDetails. recommendation	object شیء recommendation حاوی اطلاعاتی در مورد یک منبع توصیه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type recommendation باشد.
contentDetails.recommendation. resourceId	object شی resourceId حاوی اطلاعاتی است که منبع توصیه شده را شناسایی می کند.
contentDetails.recommendation.resourceId. kind	string نوع منبع API.
contentDetails.recommendation.resourceId. videoId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد ویدیو استفاده می‌کند، اگر منبع توصیه‌شده یک ویدیو باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#video باشد.
contentDetails.recommendation.resourceId. channelId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانال استفاده می‌کند، اگر منبع توصیه‌شده یک کانال باشد. این ویژگی فقط در صورتی وجود دارد که resourceId.kind youtube#channel باشد.
contentDetails.recommendation. reason	string دلیل اینکه منبع به کاربر توصیه می شود. مقادیر معتبر برای این ویژگی عبارتند از: videoFavorited videoLiked videoWatched
contentDetails.recommendation. seedResourceId	object شی seedResourceId حاوی اطلاعاتی در مورد منبعی است که باعث ایجاد توصیه شده است.
contentDetails.recommendation.seedResourceId. kind	string نوع منبع API.
contentDetails.recommendation.seedResourceId. videoId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد ویدیو استفاده می‌کند، در صورتی که این توصیه به دلیل یک ویدیوی خاص باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind youtube#video باشد.
contentDetails.recommendation.seedResourceId. channelId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانال استفاده می‌کند، اگر این توصیه توسط یک کانال خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که seedResourceId.kind youtube#channel باشد.
contentDetails.recommendation.seedResourceId. playlistId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد فهرست پخش استفاده می‌کند، در صورتی که توصیه توسط یک لیست پخش خاص ایجاد شده باشد. این ویژگی فقط در صورتی وجود دارد که 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 شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد ویدیوی نمایش داده شده در یک پست شبکه اجتماعی استفاده می‌کند، در صورتی که پست به یک ویدیو اشاره دارد. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#video باشد.
contentDetails.social.resourceId. channelId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانالی که در یک پست شبکه اجتماعی نشان داده شده است، استفاده می‌کند، در صورتی که پست به یک کانال اشاره دارد. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#channel باشد.
contentDetails.social.resourceId. playlistId	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد فهرست پخش در یک پست شبکه اجتماعی استفاده می‌کند، اگر پست به یک لیست پخش اشاره دارد. این ویژگی فقط در صورتی وجود خواهد داشت که مقدار ویژگی social.resourceId.kind youtube#playlist باشد.
contentDetails.social. author	string نویسنده پست شبکه اجتماعی.
contentDetails.social. referenceUrl	string آدرس پست شبکه اجتماعی.
contentDetails.social. imageUrl	string تصویری از نویسنده پست
contentDetails. channelItem	object شی channelItem حاوی جزئیاتی در مورد منبعی است که به یک کانال اضافه شده است. این ویژگی فقط در صورتی وجود دارد که snippet.type channelItem باشد.
contentDetails.channelItem. resourceId	object شی resourceId حاوی اطلاعاتی است که منبع اضافه شده به کانال را مشخص می کند.