PHP Quick Start

این راهنمای شروع سریع نحوه راه‌اندازی یک برنامه خط فرمان ساده و PHP را توضیح می‌دهد که درخواست‌هایی را به YouTube Data API ارسال می‌کند. این شروع سریع در واقع نحوه ایجاد دو درخواست API را توضیح می دهد:

  1. برای بازیابی اطلاعات کانال YouTube GoogleDevelopers از یک کلید API استفاده می کنید که برنامه شما را شناسایی می کند.
  2. شما از شناسه مشتری OAuth 2.0 برای ارسال یک درخواست مجاز استفاده می کنید که اطلاعات مربوط به کانال YouTube شما را بازیابی می کند.

پیش نیازها

برای اجرای این شروع سریع، به موارد زیر نیاز دارید:

  • PHP 5.4 یا بالاتر با رابط خط فرمان (CLI) و پسوند JSON نصب شده است.
  • ابزار مدیریت وابستگی Composer به صورت جهانی نصب شده است {: target="_blank"}
  • Google APIs Client Library برای PHP:
    • اگر قبلاً کتابخانه مشتری را نصب نکرده اید:
      composer require google/apiclient:^2.0
    • اگر قبلاً کتابخانه سرویس گیرنده را نصب کرده‌اید، توصیه می‌کنیم آن را به‌روزرسانی کنید تا مطمئن شوید که به‌روزترین کلاس‌ها را برای کتابخانه‌ای که آزمایش می‌کنید دارید:
      composer update google/apiclient --with-dependencies

مرحله 1: پروژه و اعتبارنامه خود را تنظیم کنید

یک پروژه را در کنسول API ایجاد یا انتخاب کنید. کارهای زیر را در کنسول API برای پروژه خود انجام دهید:

  1. در پانل کتابخانه ، YouTube Data API v3 را جستجو کنید. روی لیست آن API کلیک کنید و مطمئن شوید که API برای پروژه شما فعال است.

  2. در پانل اعتبار ، دو اعتبار ایجاد کنید:

    1. ایجاد یک کلید API برای ایجاد درخواست های API که نیازی به مجوز کاربر ندارند از کلید API استفاده خواهید کرد. به عنوان مثال، برای بازیابی اطلاعات یک کانال عمومی YouTube نیازی به مجوز کاربر ندارید.

    2. ایجاد شناسه مشتری OAuth 2.0 نوع برنامه را روی Other تنظیم کنید. برای درخواست هایی که نیاز به مجوز کاربر دارند، باید از اعتبارنامه OAuth 2.0 استفاده کنید. به عنوان مثال، برای بازیابی اطلاعات مربوط به کانال یوتیوب کاربر تأیید شده فعلی، به مجوز کاربر نیاز دارید.

      فایل JSON را که حاوی اطلاعات کاربری OAuth 2.0 شما است دانلود کنید. این فایل دارای نامی مانند client_secret_CLIENTID.json است که در آن CLIENTID شناسه مشتری پروژه شما است.

مرحله 2: نمونه را تنظیم و اجرا کنید

از ویجت APIs Explorer در پانل کناری برای دریافت کد نمونه برای بازیابی اطلاعات مربوط به کانال YouTube GoogleDevelopers استفاده کنید. این درخواست از یک کلید API برای شناسایی برنامه شما استفاده می کند و نیازی به مجوز کاربر یا مجوزهای خاصی از کاربر در حال اجرا نمونه ندارد.

  1. اسناد مربوط به روش channels.list API را باز کنید.
  2. در آن صفحه، بخش «موارد استفاده متداول» حاوی جدولی است که چندین روش رایج استفاده از این روش را توضیح می‌دهد. اولین لیست در جدول برای لیست کردن نتایج بر اساس شناسه کانال است.

    روی نماد کد اولین فهرست کلیک کنید تا APIs Explorer تمام صفحه باز و پر شود.

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

  3. سمت چپ APIs Explorer تمام صفحه موارد زیر را نشان می دهد:

    1. در زیر سربرگ پارامترهای درخواست ، لیستی از پارامترهایی وجود دارد که این روش از آنها پشتیبانی می کند. مقادیر پارامتر part و id باید تنظیم شوند. مقدار پارامتر id ، UC_x5XG1OV2P6uZZ5FSM9Ttw ، شناسه کانال GoogleDevelopers YouTube است.

    2. در زیر پارامترها، بخشی به نام Credentials وجود دارد. منوی کشویی در آن بخش باید مقدار کلید API را نمایش دهد. APIs Explorer به طور پیش‌فرض از اعتبارنامه‌های نمایشی استفاده می‌کند تا شروع به کار را آسان‌تر کند. اما شما از کلید API خود برای اجرای نمونه به صورت محلی استفاده خواهید کرد.

      تصویری که «Credentials» را در تمام صفحه APIs Explorer و منوی کشویی با گزینه «کلید API» انتخاب شده نشان می‌دهد.

  4. سمت راست APIs Explorer تمام صفحه برگه هایی را با نمونه کد به زبان های مختلف نشان می دهد. تب PHP را انتخاب کنید.

  5. نمونه کد را کپی کرده و در فایلی به نام example.php ذخیره کنید.

  6. در نمونه ای که دانلود کردید، رشته YOUR_API_KEY را پیدا کنید و آن را با کلید API که در مرحله 1 این شروع سریع ایجاد کردید جایگزین کنید.

  7. نمونه را از خط فرمان اجرا کنید. در پوشه کاری خود، اجرا کنید:

    php example.php

  8. نمونه باید درخواست را اجرا کند و پاسخ STDOUT را چاپ کند.

مرحله 3: یک درخواست مجاز را اجرا کنید

در این مرحله، نمونه کد خود را طوری تغییر می‌دهید که به جای بازیابی اطلاعات مربوط به کانال YouTube GoogleDevelopers، اطلاعات مربوط به کانال YouTube شما را بازیابی کند. این درخواست نیاز به مجوز کاربر دارد.

  1. به مستندات روش channels.list API بازگردید.

  2. در بخش «موارد استفاده متداول»، روی نماد کد فهرست سوم در جدول کلیک کنید. این مورد استفاده فراخوانی متد list برای «کانال من» است.

  3. مجدداً، در سمت چپ APIs Explorer تمام صفحه، لیستی از پارامترها را مشاهده خواهید کرد که به دنبال آن بخش Credentials قرار دارد. با این حال، دو تغییر نسبت به مثالی که در آن اطلاعات مربوط به کانال GoogleDevelopers را بازیابی کردید، وجود دارد:

    1. در قسمت پارامترها به جای اینکه مقدار پارامتر id تنظیم شود، مقدار پارامتر mine باید روی true تنظیم شود. این به سرور API دستور می دهد تا اطلاعات مربوط به کانال کاربر تأیید شده فعلی را بازیابی کند.

    2. در بخش اعتبارنامه‌ها ، منوی کشویی باید گزینه Google OAuth 2.0 را انتخاب کند.

      علاوه بر این، اگر روی پیوند Show scopes کلیک کنید، محدوده https://www.googleapis.com/auth/youtube.readonly باید بررسی شود.

      تصویری که دامنه‌ها را در APIs Explorer تمام صفحه نشان می‌دهد و گزینه استفاده از اطلاعات کاربری «Google OAuth 2.0» انتخاب شده است.

  4. مانند مثال قبلی، تب PHP را انتخاب کنید، نمونه کد را کپی کنید و آن را در example.php ذخیره کنید.

    در کد، رشته YOUR_CLIENT_SECRET_FILE.json را پیدا کنید و آن را با محل فایل مخفی کلاینت که در مرحله 1 این شروع سریع دانلود کرده اید جایگزین کنید.

  5. نمونه را از خط فرمان اجرا کنید. در پوشه کاری خود، اجرا کنید:

    php example.php

  6. URL را از کنسول کپی کرده و در مرورگر خود باز کنید.

    اگر قبلاً وارد حساب Google خود نشده‌اید، از شما خواسته می‌شود که وارد شوید. اگر به چندین حساب Google وارد شده‌اید، از شما خواسته می‌شود یک حساب را برای استفاده برای مجوز انتخاب کنید.

  7. روی دکمه کلیک کنید تا برنامه شما به محدوده های مشخص شده در نمونه کد شما دسترسی پیدا کند.

  8. کد احراز هویت را از مرورگر کپی کرده و در ترمینال خود قرار دهید. سپس می توانید برگه مرورگر مورد استفاده برای جریان احراز هویت را ببندید.

    پاسخ API باید دوباره در STDOUT چاپ شود.

در ادامه مطلب