إضافة معلومات مفصّلة

تتيح الإضافات لتطبيقك التحكّم في بنية الصور وعرضها في ألبوم في "صور Google". تتيح لك هذه العناصر تقديم سياق إضافي للمستخدم من خلال التعليقات التوضيحية للنص أو الموقع الجغرافي وترتيب/تجميع الصور التي تسرد قصة معًا.

نطاق التفويض المطلوب

تتطلّب إضافة تحسينات إلى الألبومات التي أنشأها التطبيق الحصول على نطاق photoslibrary.appendonly . لمزيد من المعلومات عن النطاقات، يُرجى الاطّلاع على نطاقات التفويض.

أنواع التحسين

يدعم تطبيق "صور Google" ثلاثة أنواع من العناصر الإضافية في الألبومات: النصوص والمواقع الجغرافية والخرائط.

إثراء النص

تحسين النص هو سلسلة نصية عادية يمكن إدراجها لإضافة تعليق توضيحي إلى الألبوم.

تحسينات الموقع الجغرافي

تحسين الموقع الجغرافي هو علامة واسم المكان الذي يمكن إدراجه لإضافة تعليق توضيحي إلى موقع جغرافي.

تحسينات الخريطة

تحسين الخريطة هو خريطة ذات أصل ووجهة محددين يمكن إدراجهما في الألبوم.

المواضع

لإدراج عناصر الوسائط وإثراءات الألبوم، حدِّد موضع الألبوم. ويكون الموضع اختياريًا لعناصر الوسائط، ولكن يجب تحديده لإثراء الألبوم.

لا يمكن تحديد موضع إلا عند إنشاء ملف وسائط أو إضافة عمليات تحسين. لا يمكن إعادة تنظيم عناصر الوسائط الحالية في ألبوم، لذا من المهم ضبط موضع العنصر عند إضافته.

بداية الألبوم

يمكن إضافة عنصر وسائط/إثراء إلى بداية الألبوم كموقع مطلق.

نهاية الألبوم

يمكن إضافة عنصر وسائط/إثراء إلى نهاية الألبوم كموقع مطلق.

نسبةً إلى عنصر الوسائط

يمكن إضافة عنصر وسائط/إثراء إلى عنصر وسائط بدءًا من موقعه في الألبوم.

نسبة إلى عنصر التحسين

يمكن إضافة عنصر وسائط/إثراء بالنسبة إلى عنصر إثراء بدءًا بعد موضع العنصر في الألبوم.

إضافة تحسينات إلى الألبوم

تتم إضافة العناصر المحسّنة واحدة تلو الأخرى ويجب إضافتها إلى موضع في ألبوم. لإضافة تحسينات إلى ألبوم، اتصل بالرقم albums.addEnrichment.

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

REST

في ما يلي طلب POST:

POST https://photoslibrary.googleapis.com/v1/albums/album-id:addEnrichment
Content-type: application/json
Authorization: Bearer oauth2-token
request-body

يتألّف نص الطلب من عنصر التوسيع وموضعه:

{
  "newEnrichmentItem": {
    enrichment-to-be-added
  },
  "albumPosition": {
    position-of-enrichment
}

فيما يلي نموذج للرد:

{
  "enrichmentItem": {
    "id": "enrichment-item-id",
  }
}

الإضافات المتوافقة

تحسينات النصوص

تحتوي إثراء النص على سلسلة نصية واحدة (لا تزيد عن 1000 حرف)، كما هو موضح في المثال التالي:

REST

{
  "text": "Text to be shown"
}

Java

// Use the NewEnrichmentItemFactory helper to create a text enrichment item
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createTextEnrichment("text to be shown");

PHP

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithText("text to be shown");

تحسينات الموقع الجغرافي

تتألف إضافات المواقع الجغرافية من اسم موقع جغرافي عشوائي وموضع خط العرض وخط الطول. يجب أن يتألّف locationName من 500 حرف كحدّ أقصى.

REST

{
  "location": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a location enrichment
// with the name, latitude, and longitude of the location
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createLocationEnrichment("Australia", -21.197, 95.821);

PHP

// Create a new location object and set the name, latitude, and longitude of the location
$newLocation = new Location();
$newLocation->setLocationName("Australia");
$newLocation->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithLocation($newLocation);

تحسينات الخريطة

تعرِض الإضافات على الخريطة موقعَين جغرافيَّين، يتألّف كلّ منهما من اسم وخط عرض وخط طول. على غرار تحسين الموقع الجغرافي، يجب ألا يزيد عدد أحرف locationName ضمن origin وdestination عن 500 حرف.

REST

{
  "origin": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  },
  "destination": {
    "locationName": "San Francisco",
    "latlng": {
      "latitude": "37.757",
      "longitude": "122.507"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a map enrichment item for
// an origin and a destination location
NewEnrichmentItem newEnrichmentItem = NewEnrichmentItemFactory.createMapEnrichment(
    "Australia", -21.197, 95.821, // origin
    "San Francisco", 37.757, 122.507 // destination
);

PHP

// Create two new location objects to create a map enrichment item
// for an origin and a destination location
$locationAustralia = new Location();
$locationAustralia->setLocationName("Australia");
$locationAustralia->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$locationSanFrancisco = new Location();
$locationSanFrancisco->setLocationName("San Francisco");
$locationSanFrancisco->setLatlng((new LatLng())->setLatitude(37.757)->setLongitude(122.507));

$newEnrichmentItem =
  PhotosLibraryResourceFactory::newEnrichmentItemWithMap($locationAustralia, $locationSanFrancisco);

مواضع الإعلانات المتاحة

بداية الألبوم

يشير الموضع FIRST_IN_ALBUM إلى بداية الألبوم. يتم عرض العناصر الموجودة هنا للمستخدم أولاً:

REST

{
  "position": "FIRST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::FIRST_IN_ALBUM);

نهاية الألبوم

يشير الموضع LAST_IN_ALBUM إلى نهاية الألبوم. يتم عرض العناصر المتوفّرة في هذا القسم للمستخدم في آخر الأمر.

REST

{
  "position": "LAST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createLastInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::LAST_IN_ALBUM);

نسبةً إلى عنصر الوسائط

تشير تحديد الموضع relativeMediaItem إلى موضع نسبي مقارنةً بأحد عناصر الوسائط. تتم إضافة العناصر بعد ملف الوسائط المحدّد.

REST

{
  "position": "after-media-item",
  "relativeMediaItemId": "media-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterMediaItem(mediaItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterMediaItem($mediaItemId);

نسبةً إلى عنصر التحسين

تشير الإشارة إلى relativeEnrichmentItemId إلى موضع نسبي مقارنةً بأحد عناصر التحسين. تتم إضافة العناصر بعد عنصر الإثراء المحدّد.

REST

{
  "position": "after-enrichment-item",
  "relativeEnrichmentItemId": "enrichment-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterEnrichmentItem(enrichmentItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterEnrichmentItem($enrichmentItemId);

تعديل البيانات الموسّعة

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