اشتراکی را حذف می‌کند.
تأثیر سهمیه: فراخوانی این روش هزینه سهمیه ۵۰ واحدی دارد.
موارد استفاده رایج
درخواست
درخواست HTTP
DELETE https://www.googleapis.com/youtube/v3/subscriptions
صدور مجوز
این درخواست به مجوز با حداقل یکی از دامنه‌های زیر نیاز دارد (درباره اصالت‌سنجی و مجوز بیشتر بخوانید).
| حوزه |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
پارامترها
جدول زیر پارامترهایی را که این پُرسمان پشتیبانی می‌کند فهرست می‌کند. همه پارامترهای فهرست‌شده، پارامترهای پُرسمان هستند.
| پارامترها | ||
|---|---|---|
| پارامترهای الزامی | ||
id |
stringپارامتر id شناسه اشتراک YouTube را برای منبعی که حذف می‌شود مشخص می‌کند. در منبع subscription، ویژگی id شناسه اشتراک YouTube را مشخص می‌کند. |
|
متن درخواست
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
پاسخ
درصورت موفقیت، این روش کد پاسخ HTTP 204 (No Content) را برمی‌گرداند.
خطاها
جدول زیر پیام‌های خطایی را که ممکن است API در پاسخ به فراخوانی این روش برگرداند، مشخص می‌کند. برای جزئیات بیشتر، لطفاً مستندات پیام خطا را ببینید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
forbidden (403) |
subscriptionForbidden |
درخواست به‌درستی اصالت‌سنجی نشده است یا برای این کانال پشتیبانی نمی‌شود. |
notFound (404) |
subscriptionNotFound |
اشتراکی که می‌خواهید حذف کنید پیدا نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید درست باشد. |
امتحان کنید!
از APIs Explorer برای فراخوانی این API و دیدن درخواست و پاسخ API استفاده کنید.