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 حاوی اطلاعاتی است که منبع اضافه شده به کانال را مشخص می کند.