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
  • 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

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