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