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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

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

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