Groups

یک منبع group نشان دهنده یک گروه YouTube Analytics است که مجموعه ای سفارشی از حداکثر 500 کانال، ویدیو، لیست پخش یا دارایی است.

همه موارد در یک گروه باید یک نوع منبع را نشان دهند. به عنوان مثال، نمی توانید گروهی ایجاد کنید که دارای 100 ویدیو و 100 لیست پخش باشد.

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

مواد و روش ها

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

list
فهرستی از گروه‌هایی را برمی‌گرداند که با پارامترهای درخواست API مطابقت دارند. برای مثال، می‌توانید همه گروه‌هایی را که کاربر احراز هویت شده متعلق به آنهاست بازیابی کنید، یا می‌توانید یک یا چند گروه را با شناسه‌های منحصربه‌فردشان بازیابی کنید. اکنون آن را امتحان کنید .
insert
یک گروه YouTube Analytics ایجاد می کند. پس از ایجاد گروه، از روش groupItems.insert برای افزودن موارد به گروه استفاده کنید. اکنون آن را امتحان کنید .
update
ابرداده یک گروه را اصلاح می کند. در حال حاضر تنها ویژگی قابل به روز رسانی عنوان گروه است. (از groupItems.insert و groupItems.delete برای افزودن و حذف موارد گروه استفاده کنید.) اکنون آن را امتحان کنید .
delete
یک گروه را حذف می کند. اکنون آن را امتحان کنید .

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

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

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

خواص

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

خواص
kind string
نوع منبع API را مشخص می کند. مقدار youtube#group خواهد بود.
etag etag
Etag این منبع
id string
شناسه ای که YouTube برای شناسایی منحصر به فرد گروه استفاده می کند.
snippet object
شی snippet حاوی اطلاعات اولیه درباره گروه، از جمله تاریخ ایجاد و نام آن است.
snippet. publishedAt datetime
تاریخ و ساعت ایجاد گروه مقدار در قالب ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) مشخص شده است.
snippet. title string
نام گروه مقدار باید یک رشته غیر خالی باشد.
contentDetails object
شی contentDetails حاوی اطلاعات اضافی درباره گروه است، مانند تعداد و نوع مواردی که در آن وجود دارد.
contentDetails. itemCount unsigned long
تعداد آیتم های گروه
contentDetails. itemType string
نوع منابعی که گروه شامل می شود.

مقادیر معتبر برای این ویژگی عبارتند از:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset