Method: albums.addEnrichment

تُضيف ميزة "تحسين المحتوى" معلومات في موضع محدّد في ألبوم تم إنشاؤه من خلال تطبيق.

طلب HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
albumId

string

مطلوب. معرّف الألبوم الذي أنشأه التطبيق حيث سيتمّ إضافة التحسينات

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
الحقول
newEnrichmentItem

object (NewEnrichmentItem)

مطلوب. البيانات التي ستتم إضافتها
albumPosition

object (AlbumPosition)

مطلوب. موضع الإضافة في الألبوم الذي أنشأه التطبيق

نص الاستجابة

عنصر التحسين الذي تم إنشاؤه

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
الحقول
enrichmentItem

object (EnrichmentItem)

النتائج فقط. التحسين الذي تمت إضافته

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

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

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

تمثيل JSON 
{

  // Union field enrichment can be only one of the following:
  "textEnrichment": {
    object (TextEnrichment)
  },
  "locationEnrichment": {
    object (LocationEnrichment)
  },
  "mapEnrichment": {
    object (MapEnrichment)
  }
  // End of list of possible types for union field enrichment.
}
الحقول
حقل الربط enrichment المحتوى الذي سيتم تحسينه وإضافته إلى الألبوم الذي أنشأه التطبيق يمكن أن يكون هذا النص أو موقعًا جغرافيًا أو خريطة. يمكن أن يكون enrichment واحدًا فقط مما يلي:
textEnrichment

object (TextEnrichment)

النص الذي سيتمّ إضافته إلى الألبوم الذي أنشأه التطبيق
locationEnrichment

object (LocationEnrichment)

الموقع الجغرافي الذي سيتمّت إضافته إلى الألبوم الذي أنشأه التطبيق
mapEnrichment

object (MapEnrichment)

الخريطة التي سيتمّ إضافتها إلى الألبوم الذي أنشأه التطبيق

TextEnrichment

تحسين يحتوي على نص

تمثيل JSON 
{
  "text": string
}
الحقول
text

string

نص عنصر التحسين هذا.

LocationEnrichment

ميزة تحسين تتضمّن موقعًا جغرافيًا واحدًا

تمثيل JSON 
{
  "location": {
    object (Location)
  }
}
الحقول
location

object (Location)

الموقع الجغرافي لعنصر التحسين هذا.

الموقع الجغرافي

يمثّل موقعًا جغرافيًا.

تمثيل JSON 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
الحقول
locationName

string

اسم الموقع الجغرافي الذي سيتم عرضه.
latlng

object (LatLng)

موضع الموقع الجغرافي على الخريطة

LatLng

عنصر يمثّل زوجًا من خطوط العرض/خطوط الطول ويتم التعبير عن ذلك كزوج من الأعداد المزدوجة لتمثيل درجات خط العرض ودرجات خط الطول. يجب أن يكون هذا العنصر متوافقًا مع معيار WGS84 ما لم يتم تحديد خلاف ذلك. يجب أن تكون القيم ضمن النطاقات العادية.

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

خط العرض بالدرجات يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

number

خط الطول بالدرجات يجب أن تكون ضمن النطاق [-180.0, +180.0].

MapEnrichment

ميزة تحسين تتضمّن خريطة تعرض الموقعَين الجغرافيَّين لنقطة الانطلاق والوجهة

تمثيل JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
الحقول
origin

object (Location)

الموقع الجغرافي لنقطة الانطلاق لهذا العنصر الإضافي
destination

object (Location)

الموقع الجغرافي للوجهة لعنصر التحسين هذا.

EnrichmentItem

عنصر تحسين

تمثيل JSON 
{
  "id": string
}
الحقول
id

string

معرّف عنصر التحسين