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

معرّف السلعة الغنية بصريًا