این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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`