PHP क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करना

PHP क्लाइंट लाइब्रेरी के साथ Google Photos Library API का इस्तेमाल शुरू करने के लिए, आपको ये काम करने होंगे अपने डेवलपमेंट एनवायरमेंट में क्लाइंट लाइब्रेरी सेट अप करें. ऐसा करने से पहले, एपीआई चालू करके अपना प्रोजेक्ट कॉन्फ़िगर करें को ऐक्सेस किया जा सकता है.

आपका ऐप्लिकेशन इनकी ओर से Google Photos के साथ इंटरैक्ट करता है: Google Photos उपयोगकर्ता हैं. उदाहरण के लिए, जब आप किसी उपयोगकर्ता के उपयोगकर्ता की Google Photos लाइब्रेरी या मीडिया आइटम अपलोड करके Google Photos खाते का इस्तेमाल करते हैं, तो उपयोगकर्ता इन एपीआई अनुरोधों को OAuth 2.0 प्रोटोकॉल.

OAuth 2.0 क्लाइंट आईडी की मदद से आपके ऐप्लिकेशन के उपयोगकर्ता साइन इन कर सकते हैं. साथ ही, और इस प्रकार लाइब्रेरी API का उपयोग कर सकता है. Library API इस्तेमाल नहीं की जा सकती सेवा खाते; इस एपीआई का इस्तेमाल करने के लिए, उपयोगकर्ताओं को किसी मान्य Google खाते में साइन इन करना होगा खाता.

अपना ऐप्लिकेशन कॉन्फ़िगर करें

इस एपीआई को चालू करें

Library API का इस्तेमाल करने से पहले, आपको इसे अपने प्रोजेक्ट के लिए चालू करना होगा.

  1. Google के एपीआई कंसोल पर जाएं.
  2. मेन्यू बार से, कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
  3. Google API लाइब्रेरी खोलने के लिए, नेविगेशन मेन्यू से, एपीआई और सेवाएं > लाइब्रेरी.
  4. "Google Photos Library API" खोजें. सही नतीजा चुनें और क्लिक करें चालू करें.

OAuth 2.0 क्लाइंट आईडी का अनुरोध करना

OAuth क्लाइंट आईडी का अनुरोध करने और उसे अपने का इस्तेमाल करें. इस उदाहरण में ऐसे ऐप्लिकेशन का इस्तेमाल किया गया है जहां पूरा OAuth फ़्लो मौजूद है सर्वर-साइड को हैंडल किया जाता है, जैसा कि हमारे सैंपल में मौजूद सर्वर साइड पर होता है. सेटअप की प्रोसेस अलग-अलग हो सकती है लागू करने की अन्य स्थितियों के लिए.

  1. Google API कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
  2. मेन्यू से, एपीआई और सेवाएं > क्रेडेंशियल.
  3. क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी.
  4. ऐप्लिकेशन का टाइप चुनें. इस उदाहरण में, ऐप्लिकेशन टाइप वेब ऐप्लिकेशन.
  5. उन ऑरिजिन को रजिस्टर करें जिनसे आपके ऐप्लिकेशन को Google API ऐक्सेस करने की अनुमति है इस तरह से:

    1. क्लाइंट आईडी की पहचान करने के लिए कोई नाम डालें.
    2. अनुमति वाले JavaScript ऑरिजिन फ़ील्ड में, अपने है. इस फ़ील्ड में वाइल्डकार्ड इस्तेमाल नहीं किए जा सकते.

      आप एक से ज़्यादा ऑरिजिन डालकर, अपने ऐप्लिकेशन को अलग-अलग ऑरिजिन पर शामिल हैं. आपके डाले गए यूआरएल ये काम कर सकते हैं OAuth अनुरोध शुरू करें.

      नीचे दिया गया उदाहरण एक लोकल डेवलपमेंट यूआरएल दिखाता है (हमारे सैंपल, localhost:8080) और प्रोडक्शन यूआरएल भी होना चाहिए.

      http://localhost:8080
      https://myproductionurl.example.com
      
    3. अनुमति वाला रीडायरेक्ट यूआरआई फ़ील्ड वह एंडपॉइंट होता है जिसे OAuth 2.0 सर्वर से मिले रिस्पॉन्स. आम तौर पर, इसमें आपकी डेवलपमेंट एनवायरमेंट का इस्तेमाल करता है और आपके ऐप्लिकेशन के पाथ की ओर इशारा करता है.

      http://localhost:8080/auth/google/callback
      https://myproductionurl.example.com/auth/google/callback
      
    4. बनाएं पर क्लिक करें.

  1. आपको मिलने वाले OAuth क्लाइंट डायलॉग से, JSON फ़ाइल डाउनलोड करें जिसमें आपके क्लाइंट कॉन्फ़िगरेशन शामिल है. आपके क्लाइंट की जानकारी में ये शामिल हैं: फ़ॉलो किया जा रहा है:

    • Client ID
    • क्लाइंट सीक्रेट

    इस JSON फ़ाइल का इस्तेमाल, बाद में सेट अप करने के लिए किया जाएगा PHP के लिए Google पुष्टि लाइब्रेरी, जो इस क्लाइंट लाइब्रेरी के साथ काम करती है.

Library API को ऐक्सेस करने वाले सार्वजनिक ऐप्लिकेशन को लॉन्च करने से पहले, यह ज़रूरी है कि Google आपके ऐप्लिकेशन की समीक्षा करे. "पुष्टि नहीं किया गया ऐप्लिकेशन" तो मैसेज इस पर दिखता है: स्क्रीन दिखाई देती है, जब तक कि पुष्टि की गई है.

क्लाइंट लाइब्रेरी सेट अप करना

PHP क्लाइंट लाइब्रेरी आपके लिए सभी बैकएंड एपीआई कॉल हैंडल करती है और काम करने के लिए फ़्रेंडली ऑब्जेक्ट. इसमें, एपीआई के कुछ सामान्य कामों के लिए कोड के सैंपल भी शामिल हैं. सबसे पहले, PHP के लिए Google Photos Library API की क्लाइंट लाइब्रेरी को डाउनलोड और इंस्टॉल करें GitHub से डिपेंडेंसी. इसके बाद, PHP के लिए अपने OAuth2 क्रेडेंशियल सेट अप करें.

डाउनलोड करने के विकल्प

कंपोज़र का इस्तेमाल करें का इस्तेमाल करें. यह चलाकर देखेंः अपने प्रोजेक्ट के कॉन्फ़िगरेशन में लाइब्रेरी जोड़ने और डाउनलोड करने के लिए, नीचे दिए गए कमांड का इस्तेमाल करें इसे vendor/ डायरेक्ट्री में जोड़ें.

composer require google/photos-library

वैकल्पिक रूप से, आप यह भी कर सकते हैं: इसका क्लोन बनाएं डेटा स्टोर करने की जगह या कंप्रेस की गई विंडो में टारबॉल.

PHP के लिए अपने OAuth2 क्रेडेंशियल सेट अप करना

यह क्लाइंट लाइब्रेरी के लिए Google प्राधिकरण लाइब्रेरी फ़िलिपीन पेसो. ज़्यादा जानकारी के लिए, Google API क्लाइंट लाइब्रेरी के साथ OAuth 2.0 का इस्तेमाल करना फ़िलिपीन पेसो.

सेट अप करते समय पुष्टि करने के लिए, पुष्टि करने की लाइब्रेरी से मिले क्रेडेंशियल का इस्तेमाल करें PhotosLibraryClient.

कुछ नमूने आज़माएं

PHP क्लाइंट लाइब्रेरी का इस्तेमाल करके, अपना पहला एपीआई कॉल करने के लिए, नीचे दिया गया कोड आज़माएं.

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 पर सैंपल कमाई की जा सकती है.