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

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

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

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

إعداد تطبيقك

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

قبل أن تتمكن من استخدام واجهات برمجة تطبيقات الصور، يجب تفعيلها لمشروعك.

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

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

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

انتقِل إلى وحدة تحكّم واجهة برمجة تطبيقات Google واختَر مشروعك.
من القائمة، حدد واجهات برمجة التطبيقات الخدمات > بيانات الاعتماد:
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > معرِّف عميل 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 Auth لبرنامج PHP التي تعمل مع مكتبة العميل هذه.

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

إعداد مكتبة العميل

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

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

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

composer require google/photos-library

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

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

تعمل مكتبة العميل هذه مع مكتبة Google Auth لأجل 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 يمكنك تجربتها

بدء استخدام مكتبة عملاء PHP تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.