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

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

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

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

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

एपीआई चालू करना

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

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

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

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

Google API (एपीआई) कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
मेन्यू से, एपीआई और सेवाएं > क्रेडेंशियल.
क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
ऐप्लिकेशन का टाइप चुनें. इस उदाहरण में, ऐप्लिकेशन का टाइप वेब ऐप्लिकेशन है.
उन ऑरिजिन को रजिस्टर करें जिनसे आपके ऐप्लिकेशन को Google API ऐक्सेस करने की अनुमति है इस तरह से:
1. क्लाइंट आईडी की पहचान करने के लिए कोई नाम डालें.
2. अनुमति वाले JavaScript ऑरिजिन फ़ील्ड में, अपने ऐप्लिकेशन के ऑरिजिन की जानकारी डालें. इस फ़ील्ड में वाइल्डकार्ड का इस्तेमाल नहीं किया जा सकता.
  
  अपने ऐप्लिकेशन को अलग-अलग प्रोटोकॉल, डोमेन या सबडोमेन पर चलाने के लिए, एक से ज़्यादा ऑरिजिन डाले जा सकते हैं. आपके डाले गए यूआरएल ये काम कर सकते हैं OAuth अनुरोध शुरू करें.
  
  यहां दिए गए उदाहरण में, लोकल डेवलपमेंट यूआरएल (हमारे सैंपल में localhost:8080 का इस्तेमाल किया गया है) और प्रोडक्शन यूआरएल दिखाया गया है.
```
http://localhost:8080
https://myproductionurl.example.com
```
3. Authorized redirect URI फ़ील्ड, वह एंडपॉइंट होता है जिसे OAuth 2.0 सर्वर से रिस्पॉन्स मिलते हैं. आम तौर पर, इसमें आपका डेवलपमेंट एनवायरमेंट शामिल होता है और यह आपके ऐप्लिकेशन के किसी पाथ पर ले जाता है.
```
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
```
4. बनाएं पर क्लिक करें.

आपको मिलने वाले OAuth क्लाइंट डायलॉग से, JSON फ़ाइल डाउनलोड करें जिसमें आपके क्लाइंट कॉन्फ़िगरेशन शामिल है. आपके क्लाइंट की जानकारी में ये चीज़ें शामिल होती हैं:
- Client ID
- क्लाइंट सीक्रेट
इस JSON फ़ाइल का इस्तेमाल, बाद में सेट अप करने के लिए किया जाएगा PHP के लिए Google पुष्टि लाइब्रेरी, जो इस क्लाइंट लाइब्रेरी के साथ काम करती है.

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

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

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

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

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

composer require google/photos-library

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

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

यह क्लाइंट लाइब्रेरी, PHP के लिए Google Auth Library के साथ काम करती है. ज़्यादा जानकारी के लिए, 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 पर, आज़माने के लिए और भी सैंपल उपलब्ध हैं.