بدء استخدام مكتبة عملاء PHP

لبدء استخدام Google Photos Library API مع مكتبة برامج PHP، عليك تنفيذ ما يلي: إعداد مكتبة العملاء في بيئة التطوير التي تستخدمها. وقبل إجراء ذلك، عليك ضبط مشروعك من خلال تفعيل واجهة برمجة التطبيقات. عبر وحدة التحكم في واجهة Google API وإعداد معرِّف عميل OAuth 2.0.

يتفاعل تطبيقك مع "صور Google" نيابةً عن مستخدم "صور Google" على سبيل المثال، عند إنشاء ألبومات في حساب مكتبة "صور Google" أو تحميل ملفات الوسائط إلى حساب المستخدم على "صور Google"، يفوّض المستخدم طلبات البيانات من واجهة برمجة التطبيقات هذه عن طريق بروتوكول OAuth 2.0.

يتيح معرِّف عميل OAuth 2.0 لمستخدمي التطبيقات تسجيل الدخول والمصادقة وبالتالي استخدام واجهة برمجة تطبيقات المكتبة. لا تتوافق واجهة برمجة تطبيقات المكتبة مع حسابات الخدمة لاستخدام واجهة برمجة التطبيقات هذه، يجب أن يسجّل المستخدمون الدخول إلى حساب الحساب.

إعداد تطبيقك

تفعيل واجهة برمجة التطبيقات

قبل أن تتمكّن من استخدام Library API، يجب تفعيلها لمشروعك.

انتقِل إلى وحدة التحكم في واجهة Google API.
من شريط القوائم، اختَر مشروعًا أو أنشئ مشروعًا جديدًا.
لفتح مكتبة Google API، من قائمة التنقل، حدد واجهات برمجة التطبيقات الخدمات > المكتبة.
ابحث عن "Google Photos Library API". حدد النتيجة الصحيحة وانقر على تفعيل

طلب معرِّف عميل OAuth 2.0

اتّبِع الخطوات أدناه لطلب معرّف عميل OAuth وإعداده لحسابك. التطبيق. يستخدم هذا المثال تطبيقًا حيث يكون مسار OAuth كاملاً التعامل معها من جانب الخادم، مثل تلك الموجودة في العينات لدينا. قد تختلف عملية الإعداد للتعرّف على سيناريوهات التنفيذ الأخرى.

انتقِل إلى وحدة التحكم في واجهة Google API. واختر مشروعك.
من القائمة، حدد واجهات برمجة التطبيقات الخدمات > بيانات الاعتماد:
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات الاعتماد >. معرِّف عميل OAuth.
اختَر نوع التطبيق. في هذا المثال، يكون نوع التطبيق تطبيق الويب.
تسجيل المصادر التي يُسمح لتطبيقك من خلالها بالوصول إلى واجهات Google APIs على النحو التالي:
1. لتحديد معرِّف العميل، أدخِل اسمًا.
2. في الحقل مصادر JavaScript المعتمَدة، أدخِل مصدر التطبيق. لا يسمح هذا الحقل باستخدام أحرف البدل.
  
  يمكنك إدخال مصادر متعددة للسماح بتشغيل تطبيقك على أو البروتوكولات أو النطاقات أو النطاقات الفرعية. يُسمح لعناوين 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. انقر على إنشاء.

من مربّع حوار عميل OAuth الناتج، نزِّل ملف JSON. يتضمن تكوين البرنامج. تتكون تفاصيل العميل من التالي:
- معرِّف العميل
- سر العميل
سيتم استخدام ملف JSON هذا لاحقًا للإعداد. مكتبة مصادقة Google للغة PHP والتي تعمل مع مكتبة البرامج هذه.

قبل أن تتمكّن من تشغيل تطبيق عام يمكنه الوصول إلى واجهة برمجة تطبيقات المكتبة، يجب أن تراجع Google تطبيقك. "تطبيق لم يتم التحقّق منه" تظهر في صفحة الشاشة عند اختبار تطبيقك، إلى أن التحقق منه.

إعداد مكتبة البرامج

تعالج مكتبة برامج PHP جميع طلبات البيانات من واجهة برمجة التطبيقات الخاصة بالخلفية، وتعرضها للعمل بها، بما في ذلك عيّنات التعليمات البرمجية لبعض المهام الشائعة في واجهة برمجة التطبيقات. أولاً، عليك تنزيل وتثبيت مكتبة برامج واجهة برمجة التطبيقات Google Photos Library API للغة PHP مع والتبعيات من GitHub. بعد ذلك، يمكنك إعداد بيانات اعتماد OAuth2 للغة PHP.

خيارات التنزيل

استخدام composer لتضمين المكتبة كتبعية في بيئة التطوير الخاصة بك. تشغيل التالي لإضافة المكتبة إلى إعدادات مشروعك وتنزيله إلى دليل vendor/.

composer require google/photos-library

بدلاً من ذلك، يمكنك أيضًا استنساخ المستودع أو تنزيل ملف مضغوط tarball.

إعداد بيانات اعتماد OAuth2 للغة PHP

تعمل مكتبة البرامج هذه مع مكتبة مصادقة Google لـ لغة PHP لمزيد من المعلومات راجع استخدام OAuth 2.0 مع مكتبة برامج Google API للاطلاع على لغة PHP

استخدام بيانات اعتماد المصادقة التي تعرضها مكتبة المصادقة عند الإعداد 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 يمكنك تجربتها