পিএইচপি ক্লায়েন্ট লাইব্রেরি দিয়ে শুরু করুন

PHP ক্লায়েন্ট লাইব্রেরির সাথে Google Photos Library API ব্যবহার শুরু করতে, আপনাকে আপনার ডেভেলপমেন্ট পরিবেশে ক্লায়েন্ট লাইব্রেরি সেট আপ করতে হবে। আপনি এটি করার আগে, Google API কনসোলের মাধ্যমে API সক্ষম করে এবং একটি OAuth 2.0 ক্লায়েন্ট আইডি সেট আপ করে আপনার প্রকল্পটি কনফিগার করুন

আপনার অ্যাপ্লিকেশনটি Google Photos ব্যবহারকারীর হয়ে Google Photos-এর সাথে ইন্টারঅ্যাক্ট করে। উদাহরণস্বরূপ, আপনি যখন কোনো ব্যবহারকারীর Google Photos লাইব্রেরিতে অ্যালবাম তৈরি করেন বা কোনো ব্যবহারকারীর Google Photos অ্যাকাউন্টে মিডিয়া আইটেম আপলোড করেন, তখন ব্যবহারকারী OAuth 2.0 প্রোটোকলের মাধ্যমে এই API অনুরোধগুলি অনুমোদন করে।

OAuth 2.0 ক্লায়েন্ট আইডি আপনার অ্যাপ্লিকেশন ব্যবহারকারীদের সাইন ইন, প্রমাণীকরণ এবং এর মাধ্যমে লাইব্রেরি API ব্যবহার করার অনুমতি দেয়। লাইব্রেরি API পরিষেবা অ্যাকাউন্ট সমর্থন করে না; এই API ব্যবহার করতে, ব্যবহারকারীদের অবশ্যই একটি বৈধ Google অ্যাকাউন্টে সাইন ইন করতে হবে৷

আপনার অ্যাপ কনফিগার করুন

API সক্ষম করুন

আপনি লাইব্রেরি API ব্যবহার করার আগে, আপনাকে অবশ্যই আপনার প্রকল্পের জন্য এটি সক্ষম করতে হবে৷

  1. Google API কনসোলে যান।
  2. মেনু বার থেকে, একটি প্রকল্প নির্বাচন করুন বা একটি নতুন প্রকল্প তৈরি করুন৷
  3. Google API লাইব্রেরি খুলতে, নেভিগেশন মেনু থেকে, APIs & Services > Library নির্বাচন করুন।
  4. "Google Photos Library API" অনুসন্ধান করুন। সঠিক ফলাফল নির্বাচন করুন এবং সক্রিয় ক্লিক করুন।

একটি OAuth 2.0 ক্লায়েন্ট আইডি অনুরোধ করুন

একটি OAuth ক্লায়েন্ট আইডি অনুরোধ করতে এবং আপনার অ্যাপ্লিকেশনের জন্য এটি কনফিগার করতে নীচের পদক্ষেপগুলি অনুসরণ করুন৷ এই উদাহরণটি এমন একটি অ্যাপ্লিকেশন ব্যবহার করে যেখানে সমগ্র OAuth প্রবাহ সার্ভার-সাইড পরিচালনা করা হয়, যেমন আমাদের নমুনাগুলির মধ্যে একটি। অন্যান্য বাস্তবায়ন পরিস্থিতির জন্য সেটআপ প্রক্রিয়া পরিবর্তিত হতে পারে।

  1. Google API কনসোলে যান এবং আপনার প্রকল্প নির্বাচন করুন।
  2. মেনু থেকে, APIs & Services > Credentials নির্বাচন করুন।
  3. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন > OAuth ক্লায়েন্ট আইডি ক্লিক করুন।
  4. আপনার আবেদনের ধরন নির্বাচন করুন। এই উদাহরণে, অ্যাপ্লিকেশনের ধরন হল ওয়েব অ্যাপ্লিকেশন
  5. যেখান থেকে আপনার অ্যাপকে Google API গুলি অ্যাক্সেস করার অনুমতি দেওয়া হয়েছে তা নিম্নরূপ নিবন্ধন করুন:

    1. ক্লায়েন্ট আইডি সনাক্ত করতে, একটি নাম লিখুন।
    2. অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন ফিল্ডে, আপনার অ্যাপের মূল লিখুন। এই ক্ষেত্রটি ওয়াইল্ডকার্ডের অনুমতি দেয় না।

      আপনার অ্যাপটিকে বিভিন্ন প্রোটোকল, ডোমেন বা সাবডোমেনে চালানোর অনুমতি দিতে আপনি একাধিক অরিজিন লিখতে পারেন। আপনি যে URLগুলি লিখছেন সেগুলিকে একটি OAuth অনুরোধ শুরু করার অনুমতি দেওয়া হয়েছে৷

      নিম্নলিখিত উদাহরণ একটি স্থানীয় উন্নয়ন URL (আমাদের নমুনা localhost:8080 ) এবং একটি উত্পাদন URL দেখায়।

      http://localhost:8080
      https://myproductionurl.example.com
      
    3. অনুমোদিত পুনঃনির্দেশ URI ক্ষেত্র হল শেষ পয়েন্ট যা OAuth 2.0 সার্ভার থেকে প্রতিক্রিয়া গ্রহণ করে। সাধারণত, এটি আপনার বিকাশের পরিবেশকে অন্তর্ভুক্ত করে এবং আপনার অ্যাপ্লিকেশনে একটি পথ নির্দেশ করে।

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. তৈরি করুন ক্লিক করুন।

  1. ফলস্বরূপ OAuth ক্লায়েন্ট ডায়ালগ থেকে, আপনার ক্লায়েন্ট কনফিগারেশন ধারণকারী JSON ফাইলটি ডাউনলোড করুন। আপনার ক্লায়েন্টের বিবরণ নিম্নলিখিতগুলি নিয়ে গঠিত:

    • ক্লায়েন্ট আইডি
    • ক্লায়েন্ট গোপন

    এই JSON ফাইলটি পরে PHP-এর জন্য Google Auth লাইব্রেরি সেট আপ করতে ব্যবহার করা হবে যা এই ক্লায়েন্ট লাইব্রেরির সাথে কাজ করে।

আপনি লাইব্রেরি API অ্যাক্সেস করে এমন একটি সর্বজনীন অ্যাপ্লিকেশন চালু করার আগে, আপনার অ্যাপটি অবশ্যই Google দ্বারা পর্যালোচনা করা উচিত। আপনি যখন আপনার আবেদন পরীক্ষা করেন তখন একটি "অযাচাই করা অ্যাপ" বার্তাটি স্ক্রিনে উপস্থিত হয়, যতক্ষণ না এটি যাচাই করা হয়৷

ক্লায়েন্ট লাইব্রেরি সেট আপ করুন

পিএইচপি ক্লায়েন্ট লাইব্রেরি আপনার জন্য সমস্ত ব্যাকএন্ড API কল পরিচালনা করে এবং কিছু সাধারণ API কাজের জন্য কোড নমুনা সহ কাজ করার জন্য বন্ধুত্বপূর্ণ বস্তুগুলিকে প্রকাশ করে৷ প্রথমত, GitHub থেকে নির্ভরতা সহ PHP-এর জন্য Google Photos Library API ক্লায়েন্ট লাইব্রেরি ডাউনলোড এবং ইনস্টল করুন। তারপর, PHP-এর জন্য আপনার OAuth2 শংসাপত্র সেট আপ করুন।

ডাউনলোড অপশন

আপনার উন্নয়ন পরিবেশে একটি নির্ভরতা হিসাবে লাইব্রেরি অন্তর্ভুক্ত করতে কম্পোজার ব্যবহার করুন। আপনার প্রোজেক্ট কনফিগারেশনে লাইব্রেরি যোগ করতে নিম্নলিখিত কমান্ডটি চালান এবং এটিকে vendor/ ডিরেক্টরিতে ডাউনলোড করুন।

composer require google/photos-library

বিকল্পভাবে, আপনি সংগ্রহস্থল ক্লোন করতে পারেন বা একটি সংকুচিত টারবল ডাউনলোড করতে পারেন।

PHP-এর জন্য আপনার OAuth2 শংসাপত্র সেট আপ করুন

এই ক্লায়েন্ট লাইব্রেরিটি PHP এর জন্য Google Auth Library এর সাথে কাজ করে। আরও তথ্যের জন্য, PHP-এর জন্য Google API ক্লায়েন্ট লাইব্রেরির সাথে OAuth 2.0 ব্যবহার করা দেখুন।

PhotosLibraryClient সেট আপ করার সময় প্রমাণীকরণ লাইব্রেরি দ্বারা প্রত্যাবর্তিত প্রমাণীকরণ শংসাপত্রগুলি ব্যবহার করুন৷

কিছু নমুনা চেষ্টা করুন

পিএইচপি ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আপনার প্রথম API কল করতে নীচের কোডটি চেষ্টা করুন।

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

আপনার চেষ্টা করার জন্য GitHub-এ আরও নমুনা রয়েছে।