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

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