الأسئلة الشائعة

    نظرة عامة

  1. ما المقصود بواجهة برمجة التطبيقات لبيانات Google؟
  2. لديّ طلب ميزة أو تقرير خطأ. أين يجب أن أنشر؟
  3. أين يمكنني طرح سؤال على واجهة برمجة تطبيقات معيّنة؟
  4. ما هو JSON؟
  5. هل يجب أن أستخدم XML؟ هل تتوفر تنسيقات بيانات أخرى؟
  6. لماذا تستخدم REST؟
  7. هل لديك أي نصائح أو نموذج رمز قصير للمشاكل الشائعة؟
  8. هل تتوفّر واجهة برمجة تطبيقات للبيانات في Gmail؟
  9. المصادقة

  10. ما هو اسم الخدمة في ClientLogin لكل واجهة برمجة تطبيقات للبيانات؟
  11. عندما يسجل المستخدم الخروج من أحد التطبيقات، هل يلزم إبلاغ خوادم واجهة برمجة التطبيقات؟
  12. هل يتضمّن الرمز المميّز لمصادقة ClientLogin تاريخ انتهاء صلاحية؟
  13. لدي سؤال عام حول حسابات Google. إلى أين يجب أن أذهب؟
  14. كيف يمكنني المصادقة على واجهة برمجة التطبيقات؟
  15. ما القيمة التي يجب استخدامها لمعلّمة نطاق AuthSub/OAuth 1؟
  16. هل هناك أنواع مختلفة من رموز AuthSub المميزة؟ هل تنتهي صلاحية الرموز المميزة؟
  17. ما الفرق الرئيسي بين ClientLogin وAuthSub/OAuth 1؟
  18. هل يمكنني استخدام مصادقة ClientLogin في تطبيقات الويب التابعة لجهات خارجية؟
  19. ما المقصود باختبار CAPTCHA؟
  20. كيف يمكنني إنشاء اختبار CAPTCHA؟
  21. هل يجب استخدام ClientLogin في تطبيق الويب؟
  22. كيف يمكنني معرفة اسم مستخدم المستخدم عند استخدام AuthSub/OAuth 1؟
  23. كيف يمكنني استخدام OAuth 1 مع مكتبات برامج Google Data API؟
  24. كيف يمكنني استخدام AuthSub مع مكتبات برامج Google Data API؟
  25. كيف يمكنني استخدام ClientLogin مع مكتبات برامج Google Data API؟
  26. مكتبات العملاء

  27. ما هي لغات البرمجة التي تدعمها مكتبات العملاء على Google؟
  28. كيف يمكنني الإبلاغ عن خطأ أو طلب ميزة في إحدى مكتبات عملاء "بيانات Google"؟
  29. كيف يمكنني تفعيل خيارات تصحيح الأخطاء في مكتبات العملاء؟
  30. أين يمكنني العثور على المستندات المرجعية لصفوف مكتبة العملاء؟
  31. تحديد المشاكل وحلّها

  32. ما هي بعض الأدوات الجيدة لتصحيح أخطاء HTTP؟
  33. كيف يمكنني الحصول على معلومات تسجيل HTTP في مكتبة عميل جافا؟
  34. كيف يمكنني الحصول على معلومات تسجيل HTTP في مكتبة عميل NET.؟
  35. كيف يمكنني تفعيل ترميز gzip من خلاصات بيانات Google؟
  36. لماذا تظهر رسالة الخطأ "يتعذر الاتصال بـ sslv2" عند استخدام برنامج PHP؟
  37. كيف يمكنني الحصول على مستند خدمة Atom الذي يصف خلاصة؟

نظرة عامة

ما المقصود بواجهة برمجة التطبيقات لبيانات Google؟

واجهة برمجة تطبيقات بيانات Google هي واجهة برمجة تطبيقات تستند إلى بروتوكول بيانات Google. يعتمد بروتوكول Google Data على تنسيقات المشاركة Atom 1.0 وRSS 2.0 بالإضافة إلى بروتوكول النشر Atom (APP).

يعمل بروتوكول بيانات Google على توسيع نطاق تلك المعايير بطرق مختلفة باستخدام آليات الإضافة المدمجة في المعايير. تتوافق الخلاصات مع تنسيق Atom أو تنسيق RSS لمشاركة المحتوى. يتوافق نموذج النشر مع بروتوكول النشر بتنسيق Atom.

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

لدي طلب ميزة أو تقرير خطأ. أين يجب أن أنشر؟
اطّلع على أداة تتبع المشاكل. ابحث عن طلب الميزة وتمييزه بنجمة لإضافة الدعم والحصول على تحديثات حول حالته.
أين يجب طرح سؤال حول واجهة برمجة تطبيقات معينة؟
إذا لم تكن مشكلتك مدرجة هنا أو إذا كنت تريد الحصول على مزيد من التوضيح، هناك مجموعات مناقشة خاصة بكل واجهة برمجة تطبيقات لبيانات Google:
ما هو JSON؟

يشير JSON إلى تدوين كائن JavaScript.

تنسيق JSON هو تنسيق خفيف وبسيط لتبادل البيانات، ما أدى إلى بساطة استخدامه بين مطوّري الويب. إنها سهلة القراءة والكتابة، ويمكنك تحليلها باستخدام أي لغة برمجة، كما يتم تركيب بُنىها مباشرةً مع بنى البيانات المستخدمة في معظم لغات البرمجة.

تعرَّف على المزيد من المعلومات عن استخدام JSON مع Google Data APIs.

هل يتعين عليّ استخدام XML؟ هل تتوفر تنسيقات بيانات أخرى؟
يكون تنسيق البيانات التلقائي لـ Google Data APIs هو XML على شكل خلاصة Atom. وعند طلب خلاصة، يمكنك تحديد تنسيق بديل باستخدام معلمة طلب البحث alt.
  • alt=rss
    يتم تنسيق بيانات الاستجابة كخلاصة RSS.
  • تعرض alt=json أو alt=json-in-script
    تمثيل JSON لبنية XML لخلاصة Atom. وتكمن الفائدة الإضافية لـ JSON في أنه من الأسهل "تحليل" شفرة برنامج جافا سكريبت. في الوقت الحالي، لا يتوفر استخدام JSON إلا للقراءة فقط. ومع ذلك، يتيح استخدام مكتبة عميل JavaScript مع خدمات Blogger أو جهات الاتصال أو التقويم إمكانية قراءة البيانات وكتابتها على حدٍ سواء.

    يمكنك الاطّلاع على المزيد من المعلومات حول طلب خلاصات JSON واستخدامها.

  • alt=atom-in-script
    مشابه لـ alt=json-in-script، ولكن يتم عرض النتائج كسلسلة بتنسيق Atom XML بدلاً من JSON.
  • alt=rss-in-script
    مشابه لـ alt=atom-in-script، ولكن يتم عرض النتائج كسلسلة بتنسيق XML بتنسيق RSS بدلاً من تنسيق Atom.

اطّلِع على مزيد من المعلومات حول التنسيقات البديلة في الدليل المرجعي للبيانات في Google.

لماذا تستخدم REST؟
تم تصميم تطبيق REST بسيط وخفيف الوزن وقابل للتطوير، ويمثّل الخرائط على أفضل نحو ممكن لتمثيل البيانات وعرضها.
هل لديك أي نصائح أو نموذج رمز قصير للمشاكل الشائعة؟
يجب تصفُّح مدوّنة نصائح حول "واجهة برمجة التطبيقات لبيانات Google" للحصول على المساعدة في كلٍّ من مكتبات العملاء وتقديم الطلبات الأولية.
هل لدى Gmail واجهة برمجة تطبيقات للبيانات؟

لا، ولكن يمكنك استخدام خلاصة Atom في Gmail مع AuthSub أو OAuth 1 لطلب حق الوصول للقراءة فقط إلى رسائل المستخدم غير المقروءة. ويجب ضبط النطاق على https://mail.google.com/mail/feed/atom/. مثال على طلب البحث سيكون:

GET https://mail.google.com/mail/feed/atom/

إذا كنت مهتمًا بإدارة بريدك، فإن Gmail يوفر أيضًا دعم الوصول عبر IMAP/POP.


المصادقة

في مستندات Google Data APIs، يشير "OAuth" إلى OAuth 1، وللحصول على تفاصيل OAuth 2.0، يُرجى الاطّلاع على وثائق واجهة برمجة التطبيقات الفردية.

ما اسم الخدمة في ClientLogin لكل واجهة برمجة تطبيقات للبيانات؟
"اسم الخدمة" هو سلسلة موجزة يستخدمها نظام مصادقة ClientLogin لتحديد خدمة Google.
Google API اسم الخدمة
واجهات برمجة التطبيقات لبيانات Google Analytics analytics
G Suite APIs
(معلومات النطاق وإدارته)
apps
واجهة برمجة التطبيقات لبيانات مواقع Google jotspot
واجهة برمجة تطبيقات بيانات Blogger blogger
واجهة برمجة التطبيقات لبيانات بحث الكتب print
واجهة برمجة التطبيقات لبيانات التقويم cl
واجهة برمجة التطبيقات لبيانات Google Code Search codesearch
واجهة برمجة التطبيقات لبيانات جهات الاتصال cp
واجهة برمجة تطبيقات المحتوى في Shopping structuredcontent
واجهة برمجة التطبيقات لبيانات قائمة المستندات writely
واجهة برمجة التطبيقات لبيانات Finance finance
خلاصة Atom في Gmail mail
واجهة برمجة التطبيقات لبيانات Health health
weaver (وضع الحماية H9)
واجهات برمجة التطبيقات لبيانات الخرائط local
واجهة برمجة التطبيقات لبيانات ألبومات الويب بيكاسا lh2
واجهة برمجة تطبيقات بيانات الويكي الجانبي annotateweb
واجهة برمجة التطبيقات لبيانات جداول البيانات wise
واجهة برمجة التطبيقات لأدوات مشرفي المواقع sitemaps
YouTube Data API youtube

لمزيد من المعلومات عن المَعلمات الأخرى المستخدَمة في طلب ClientLogin، راجِع مستندات ClientLogin.

عندما يسجل المستخدم الخروج من أحد التطبيقات، هل يلزم إبلاغ خوادم واجهة برمجة التطبيقات؟
لا، ليس من الضروري إبلاغ Google Data API عند تسجيل خروج المستخدم من أحد التطبيقات. ومع ذلك، إذا لم يعُد تطبيقك بحاجة إلى استخدام رمز AuthSub مميَّز، يجب إبطال الرمز المميز.
هل هناك تاريخ انتهاء صلاحية لرمز مميز لمصادقة ClientLogin؟
يمكن أن يستمر الرمز المميّز لـ ClientLogin لمدة أسبوعين من تاريخ الإصدار، ولكن هذا الحدّ خاص بالخدمة ويمكن أن يكون أقصر.
لدي سؤال عام حول حسابات Google. إلى أين يجب أن أذهب؟
يُرجى زيارة مركز مساعدة حسابات Google.
كيف يمكنني المصادقة على واجهة برمجة التطبيقات؟
يجب أن يتضمّن طلب HTTP رأس مصادقة يحتوي على رمز مميّز تم الحصول عليه باستخدام إما ClientLogin أو AuthSub أو OAuth 1.
ما القيمة التي يجب استخدامها لمعلمة نطاق AuthSub/Oauth 1؟
يشترط AuthSub وOAuth 1 استخدام معلَمة scope لتحديد خدمات Google التي يمكن لتطبيقك الوصول إليها. للحصول على تفاصيل بروتوكول OAuth 2.0، راجِع وثائق واجهة برمجة التطبيقات المُحدَّدة.

Google API اسم خدمة ClientLogin
Google Analytics Data API https://www.google.com/analytics/feeds/
واجهة برمجة التطبيقات لبيانات مواقع Google http(s)://sites.google.com/feeds/
واجهة برمجة تطبيقات بيانات Blogger http://www.blogger.com/feeds/
واجهة برمجة التطبيقات لبيانات بحث الكتب http://www.google.com/books/feeds/
واجهة برمجة التطبيقات لبيانات التقويم http(s)://www.google.com/calendar/feeds/
واجهة برمجة التطبيقات لبيانات جهات الاتصال http(s)://www.google.com/m8/feeds/
واجهة برمجة تطبيقات المحتوى في Shopping https://www.googleapis.com/auth/structuredcontent
واجهة برمجة التطبيقات لبيانات قائمة المستندات http(s)://docs.google.com/feeds/
واجهة برمجة التطبيقات لبيانات Finance http://finance.google.com/finance/feeds/
خلاصة Atom في Gmail https://mail.google.com/mail/feed/atom/
واجهة برمجة التطبيقات لبيانات Health https://www.google.com/health/feeds/
https://www.google.com/h9/feeds/ (وضع الحماية H9)
واجهة برمجة التطبيقات لبيانات الخرائط http://maps.google.com/maps/feeds/
واجهة برمجة التطبيقات لبيانات ألبومات الويب بيكاسا http://picasaweb.google.com/data/
واجهة برمجة التطبيقات لجهات الاتصال المحمولة http://www-opensocial.googleusercontent.com/api/people
واجهة برمجة تطبيقات بيانات الويكي الجانبي http://www.google.com/sidewiki/feeds/
واجهة برمجة التطبيقات لبيانات جداول البيانات http(s)://spreadsheets.google.com/feeds/
واجهة برمجة التطبيقات لأدوات مشرفي المواقع http://www.google.com/webmasters/tools/feeds/
YouTube Data API http://gdata.youtube.com
هل هناك أنواع مختلفة من رموز AuthSub المميزة؟ هل تنتهي صلاحية الرموز المميزة؟
يتوفّر نوعان من الرموز المميزة لـ AuthSub. الطريقة الأولى هي رمز مميز للاستخدام لمرة واحدة يتم تقديمه إلى تطبيق الويب من خلال معلمة طلب البحث "الرمز المميز". وتنتهي صلاحية هذا الرمز المميّز في المرة الأولى التي يُستخدم فيه مع الخدمة التي تم إصدار الخدمة له أو عند استبداله برمز مميّز للجلسة.

لا تنتهي صلاحية الرموز المميزة للجلسة ما لم يتم إبطال الرمز المميز صراحةً من خلال المستخدم أو استدعاء واجهة برمجة التطبيقات AuthSubRevokeToken. لا يمكن استبدال رمز مميّز يُستخدم لمرة واحدة إلا برمز مميّز للجلسة إذا كان عنوان URL الأصلي للسمة AuthSubRequest يحدّد session=1 على أنه معلّمة طلب بحث.
ما الفرق الرئيسي بين ClientLogin وAuthSub/OAuth 1؟

تم تصميم AuthSub لتطبيقات الويب. يضمن ذلك إرسال بيانات اعتماد المستخدم بشكل آمن مباشرةً من متصفح الويب للمستخدم إلى خوادم Google بدلاً من إرسالها إلى موقع إلكتروني خارجي.

ClientLogin هو لتطبيقات سطح المكتب المثبتة. ويتطلب ذلك أن يرسل التطبيق صاحب الطلب بيانات اعتماد المستخدم إلى Google بالنيابة عن المستخدم.

اطّلِع على المستندات حول واجهة برمجة تطبيقات مصادقة حساب Google.

هل يمكنني استخدام مصادقة ClientLogin في تطبيقات الويب التابعة لجهات خارجية؟
يُسمح باستخدام ClientLogin في تطبيقات الويب للجهات الخارجية، ولكن لا يُنصح بها بشدة. وكإحدى أفضل الممارسات، يجب ألا يطلب تطبيق الويب مطلقًا من أي مستخدم إدخال بيانات اعتماد تسجيل الدخول الخاصة به (وقد يكون ذلك عرضةً للتطفل). وبدلاً من ذلك، يجب أن يخزّن التطبيق بيانات اعتماد المستخدم في جانب الخادم وأن يكون له "حساب خدمة" واحد يتم استخدامه دائمًا للمصادقة مع Google.
ما المقصود باختبار CAPTCHA؟
يُعد اختبار CAPTCHA (اختبار تورينغ العام المؤتمت بالكامل للتمييز بين الكمبيوتر والإنسان) نوعًا من اختبارات الاستجابة للتحديات التي يتم استخدامها لتحديد ما إذا كان المستخدم إنسانًا أم لا. المصطلح علامة تجارية مملوكة لجامعة كارنيغي ميلون. يمكنك الاطّلاع على مزيد من التفاصيل على Wikipedia. لقد نفذنا اختبار CAPTCHA في ClientLogin.
كيف يمكنني إنشاء اختبار CAPTCHA؟
يتم استخدام خوارزمية خاصة لتحديد متى يكون تحدي CAPTCHA مطلوبًا أثناء المصادقة. غالبًا ما تؤدي محاولات المصادقة المتكررة التي تتضمن بيانات اعتماد غير صحيحة إلى اختبار CAPTCHA.
هل يجب استخدام ClientLogin في تطبيق الويب؟
لا، يجب استخدام ClientLogin من خلال التطبيقات المثبّتة على الأجهزة التي يملكها المستخدم. لا يُنصح باستخدام واجهة برمجة تطبيقات ClientLogin في تطبيقات الويب ولا يُنصح بها بشدة.
كيف يمكنني معرفة اسم مستخدم المستخدم عند استخدام AuthSub/OAuth 1؟
نظرًا لأنه يتم منحك رمزًا مميزًا فقط من Google يمنح إمكانية الوصول إلى خلاصات المستخدم، قد لا تعرف اسم المستخدم التابع له. وقد يتسبب ذلك في حدوث مشكلة إذا كان عنوان URL للخلاصة الذي تريد استخدامه يحتوي على اسم المستخدم كجزء منه. في هذه الحالة، يمكنك استخدام اسم المستخدم الخاص default للإشارة إلى "المستخدم الذي أستخدم رمز المصادقة المميز الخاص به".
كيف يمكنني استخدام OAuth 1 مع مكتبات برامج Google Data API؟
راجِع المقالة استخدام OAuth 1 مع مكتبات برامج Google Data API.
كيف يمكنني استخدام AuthSub مع مكتبات برامج Google Data API؟
يمكنك الاطّلاع على المقالة استخدام AuthSub مع مكتبات برامج Google Data API.
كيف أستخدم ClientLogin مع مكتبات برامج Google Data API؟
راجع المقالة استخدام ClientLogin مع مكتبات عميل Google Data API.

مكتبات العملاء

ما هي لغات البرمجة التي تدعمها مكتبات العملاء على Google؟

تتوافق Google بشكل رسمي مع مكتبات برامج Java و.NET وPython وGoal-C. بالإضافة إلى ذلك، كتب شريكنا Zend مكتبة عميل PHP. وباستخدام هذه المكتبات، يمكنك إنشاء طلبات بروتوكول بيانات Google وإرسالها إلى إحدى الخدمات ومعالجة استجابات الخادم. وتتوفّر أيضًا مكتبة عميل JavaScript لا تتوافق حاليًا إلا مع Blogger و"تقويم Google" و"جهات اتصال Google".

إذا كنت تكتب مكتبة عميل بلغة غير Java أو Net. أو Python أو Goal-C، وتريد مشاركتها مع منتدى مطوّري برامج Data API، فانشرها في مجموعة مناقشة Google Data APIs. يُسعدنا معرفة رأيك.

كيف يمكنني الإبلاغ عن خطأ أو طلب ميزة في إحدى مكتبات العملاء؟

يمكن الإبلاغ عن الأخطاء أو طلبات الميزات لمكتبات العملاء في المواقع التالية:

بعد نشر الخطأ، أنشِئ سلسلة محادثات في منتدى مطوّري البرامج لواجهة برمجة التطبيقات المناسبة.

كيف يمكنني تفعيل خيارات تصحيح الأخطاء في مكتبات برامج Google Data API؟
يُرجى الاطّلاع على المقالة التالية للحصول على معلومات عن تفعيل تصحيح الأخطاء في بعض مكتبات العملاء: تصحيح أخطاء برامج عملاء Google Data API: استكشاف الزيارات من داخل "البرنامج"
أين يمكنني العثور على مستندات مرجعية لصفوف مكتبة العملاء؟
مكتبة العميل دليل مرجعي
لغة Java Javadoc
JavaScript JSdoc
NET. اتفاقية عدم الإفصاح
لغة PHP مستند php
لغة Python PyDoc

تحديد المشاكل وحلّها

ما هي بعض الأدوات الجيدة لتصحيح أخطاء HTTP؟

هناك عدد من الأدوات المدرَجة أدناه، ولكن ننصحك أيضًا بالاطّلاع على المقالة On the Wire: Network Capture Tools for API Developers التي توضّح أمثلة تفصيلية لكل من WireShark وFiddler.

Wireshark
Wireshark هي "أداة تحليل بروتوكول الشبكة". وتوفّر هذه الميزة إمكانية رصد حركة بيانات الشبكة وتحليل المحتوى. ويُعدّ هذا الإجراء مفيدًا جدًا في تصحيح عدد الزيارات التي تحدث في المكتبات التي لا يتوفّر لك فيها إمكانية الوصول المباشر إلى طلبات HTTP وساحات الاستجابة. لا يمكن تحليل حركة البيانات بين التطبيق وخدمات المصادقة باستخدام Wireshark حيث يتم تشفير الاتصال باستخدام طبقة المقابس الآمنة. يمكن أيضًا استخدام Wireshark لتحليل عدد الزيارات التي يتم تسجيلها باستخدام أدوات مثل الأداة tcpdump. يتوفّر Wireshark من قِبل مطوّري البرامج على شكل رمز مصدر ومثبِّت على نظام التشغيل Windows. وتتوفّر حزم الجهات الخارجية للعديد من الأنظمة الأساسية.
العزف على آلات كمان
Fiddler هو "خادم وكيل لتصحيح أخطاء HTTP". إذا كان بإمكانك إعداد الرمز أو بيئة وقت التشغيل لاستخدام خادم وكيل لزيارات HTTP، سيحدّد Fiddler بين التطبيق وخدمات بيانات Google حيث يسمح لك بفحص الزيارات. يشمل Fiddler 2 طبقة المقابس الآمنة. Fiddler متاح حاليًا لنظام التشغيل Windows فقط.
cURL
cURL هي أداة سطر أوامر يمكنها تنفيذ طلبات HTTP/HTTPS. وهو مفيد جدًا للاختبار السريع للتفاعلات مع خدمة معيّنة بدون الحاجة إلى إنشاء دعم HTTP أولاً في البرنامج.
كيف أحصل على معلومات تسجيل HTTP في مكتبة عميل جافا؟

تستخدم مكتبات برامج جافا الحزمة java.util.logging لتفعيل تسجيل طلبات HTTP. سيسمح لك هذا الإجراء بتسجيل تسجيل الرؤوس للطلبات والردود بالإضافة إلى رموز الحالة وعناوين URL للطلبات، ولكنه لا يسجّل حاليًا الطلبات الكاملة وساحات الردود. اسم المسجِّل المستخدَم لهذه السجلّات هو com.google.gdata.client.http.HttpGDataRequest.

في حال عرض رمز خطأ من الخوادم، يتم تجاهل الاستثناء. تكتسب فئات الاستثناء من com.google.gdata.util.ServiceException وتتضمن طريقة عامة تسمى getResponseBody(). يمكنك الاطّلاع على Javadoc للحصول على مزيد من المعلومات.

كيف أحصل على معلومات تسجيل HTTP في مكتبة عميل NET.؟
تستخدم مكتبة NET .طرق التتبع System.Diagnostics لتسجيل مسار التنفيذ، في حالة تمكين التتبع. أيضًا، في حالة حدوث خطأ، يتم تجاهل GDataRequestException. يحتوي الاستثناء على ResponseString الذي يتيح لك الوصول إلى نص استجابة HTTP.
كيف يمكنني تمكين تشفير gzip من خلاصات بيانات Google؟

للحصول على استجابة بترميز gzip من إحدى واجهات برمجة تطبيقات بيانات Google، يجب إجراء أمرين: تعيين الرأس "Accept-Encoding" وتعديل وكيل المستخدم ليتضمن السلسلة "gzip". مثال للعناوين التي تمت صياغتها بشكل صحيح:

User-Agent: my program (gzip)
Accept-Encoding: gzip
لماذا أرى رسالة الخطأ "تعذر الاتصال بـ sslv2" عند استخدام برنامج PHP؟

بدءًا من تموز (يوليو) 2009، بدأنا بإيقاف طبقة المقابس الآمنة (SSL) على خوادمنا كإجراء وقائي لتحسين مستوى الأمان. للأسف، هناك خطأ في الإصدارات الأولية من مكتبة برامج PHP التي تم إصدارها قبل تموز (يوليو) 2007 (الإصدار 1.0.0 والإصدارات السابقة) والذي يفرض على الاتصالات استخدام SSLv2. عند الاتصال بخادم تم إيقاف SSLv2 فيه، يؤدي ذلك إلى الخطأ التالي:

PHP Fatal error:  Uncaught exception 'Zend_Http_Client_Adapter_Exception' with message 'Unable to Connect to sslv2://www.google.com:443.'

لتصحيح هذا الخطأ، يمكنك الترقية إلى إصدار أحدث من مكتبة برامج PHP، والمتاح من خلال http://framework.zend.com/download.

إذا لم تتمكن من الترقية إلى إصدارٍ أحدث، يمكنك حل هذه المشكلة من خلال إضافة الرمز التالي إلى تطبيقك، حيث يكون $gdata هو النسخة المماثلة الحالية من Zend_Gdata (أو فئة فرعية مناسبة):

$gdata->getHttpClient()->setConfig(array('ssltransport' => 'ssl'));
كيف يمكنني الحصول على مستند خدمة Atom الذي يصف خلاصة؟

يمكنك الحصول على مستند خدمة Atom من خلال تمرير المَعلمة alt=atom-service في الطلب. ملاحظة: لن يعرض الإصدار 2 من واجهات برمجة التطبيقات لبيانات Google إلا مستند خدمة يتوافق مع بنية مستند خدمة AtomPub. سيستمر الإصدار 1 من واجهات برمجة التطبيقات لبيانات Google في عرض مستند خدمة، ولكنه يستند إلى مواصفات مسودة AtomPub السابقة (هناك تغييرات في البنية ومساحة الاسم بين الإصدارين).