‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

Activities

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

روش‌ها

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

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

نمایش منبع

ساختار 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,
      }
    },
    "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` نوع منبع میانای برنامه‌سازی کاربردی را مشخص می‌کند. مقدار `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` – تصویر ریزعکس پیش‌فرض. ریزعکس پیش‌فرض برای یک ویدیو – یا منبعی که به یک ویدیو اشاره می‌کند، مانند یک مورد فهرست پخش یا نتیجه جستجو – ۱۲۰ پیکسل عرض و ۹۰ پیکسل ارتفاع دارد. ریزعکس پیش‌فرض برای کانال ۸۸ پیکسل عرض و ۸۸ پیکسل ارتفاع دارد. `medium` – نسخه با وضوح بالاتر از تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو ارجاع می‌دهد)، این تصویر ۳۲۰ پیکسل عرض و ۱۸۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۲۴۰ پیکسل عرض و ۲۴۰ پیکسل ارتفاع دارد. `high` – نسخه با وضوح بالای تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو اشاره می‌کند)، این تصویر ۴۸۰ پیکسل عرض و ۳۶۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۸۰۰ پیکسل عرض و ۸۰۰ پیکسل ارتفاع دارد. `standard` – نسخه با وضوح حتی بالاتر از تصویر کوچک نسبت به تصویر با وضوح `high`. این تصویر برای برخی ویدیوها و منابع دیگری که به ویدیوها ارجاع می‌دهند، مانند موارد فهرست پخش یا نتایج جستجو، دردسترس است. این تصویر ۶۴۰ پیکسل عرض و ۴۸۰ پیکسل ارتفاع دارد. `maxres` – نسخه با وضوح بالای تصویر کوچک. این اندازه تصویر برای برخی‌از ویدیوها و منابع دیگری که به ویدیوها اشاره دارند، مانند موارد فهرست پخش یا نتایج جستجو، دردسترس است. این تصویر ۱۲۸۰ پیکسل عرض و ۷۲۰ پیکسل ارتفاع دارد. `fhd` – نسخه وضوح بالای کامل (۱۰۸۰ پیکسل) تصویر کوچک. این اندازه تصویر برای برخی ویدیوها دردسترس است. این تصویر ۱۹۲۰ پیکسل عرض و ۱۰۸۰ پیکسل ارتفاع دارد. `qhd` – نسخه Quad HD (‏۱۴۴۰ پیکسل / 2K) از ریزعکس. این اندازه تصویر برای برخی ویدیوها دردسترس است. این تصویر ۲۵۶۰ پیکسل عرض و ۱۴۴۰ پیکسل ارتفاع دارد. `uhd` – نسخه با وضوح بسیار بالا (4K) از تصویر کوچک. این اندازه تصویر برای برخی‌از ویدیوها دردسترس است. این تصویر ۳۸۴۰ پیکسل عرض و ۲۱۶۰ پیکسل ارتفاع دارد.
`snippet.thumbnails.(key).url`	`string` نشانی وب تصویر.
`snippet.thumbnails.(key).width`	`unsigned integer` عرض تصویر.
`snippet.thumbnails.(key).height`	`unsigned integer` ارتفاع تصویر.
`snippet.channelTitle`	`string` عنوان کانال برای کانال مسئول این فعالیت
`snippet.type`	`string` نوع فعالیتی که منبع شرح می‌دهد. مقادیر معتبر برای این ویژگی عبارتند از: `channelItem` ‫`comment` – (درحال‌حاضر برگردانده نشده است) `playlistItem` `promotedItem` `recommendation` `social` `subscription` `upload`
`snippet.groupId`	`string` شناسه گروه مرتبط با فعالیت. شناسه گروه رویدادهای کاربر را که با همان کاربر و منبع مرتبط است شناسایی می‌کند. برای مثال، اگر کاربری ویدیویی را بارگذاری کند و همان ویدیو را تماشا کند، ورودی‌های مربوط به آن رویدادها در فید فعالیت کاربر شناسه گروه یکسانی خواهند داشت. در میانای کاربر، می‌توانید با گروه‌بندی رویدادها با مقدار `groupId` یکسان، از تکرار جلوگیری کنید.
`contentDetails`	`object` شیء `contentDetails` حاوی اطلاعاتی درباره محتوای مرتبط با فعالیت است. برای مثال، اگر مقدار `snippet.type` برابر با `videoRated` باشد، محتوای شیء `contentDetails` ویدیو رده‌بندی‌شده را شناسایی می‌کند.
`contentDetails.upload`	`object` شیء `upload` حاوی اطلاعاتی درباره ویدیو بارگذاری‌شده است. این ویژگی فقط درصورتی وجود دارد که `snippet.type` برابر با `upload` باشد.
`contentDetails.upload.videoId`	`string` شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد ویدیو بارگذاری‌شده استفاده می‌کند.
`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` نوع منبع میانای برنامه‌سازی کاربردی.
`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` دلیل توصیه منبع به کاربر. مقادیر معتبر برای این دارایی عبارت‌اند از: `videoWatched`
`contentDetails.recommendation.seedResourceId`	`object` شیء `seedResourceId` حاوی اطلاعاتی درباره منبعی است که باعث توصیه شده است.
`contentDetails.recommendation.seedResourceId.kind`	`string` نوع منبع میانای برنامه‌سازی کاربردی.
`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` حاوی اطلاعاتی است که منبع اضافه‌شده به کانال را شناسایی می‌کند.

Activities با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

روش‌ها

نمایش منبع

مشخصات

Activities