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

تشير هذه السمة إلى معرّف العنصر المفيد.