- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- NewEnrichmentItem
- TextEnrichment
- LocationEnrichment
- الموقع الجغرافي
- LatLng
- MapEnrichment
- EnrichmentItem
- جرِّبه الآن
لإضافة محتوى موسيقي في موضع محدّد في ألبوم محدّد
طلب HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
albumId |
مطلوبة. تمثّل هذه السمة معرّف الألبوم الذي ستتم إضافة البيانات المفصَّلة إليه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "newEnrichmentItem": { object ( |
الحقول | |
---|---|
newEnrichmentItem |
مطلوبة. الاستفادة التي ستتم إضافتها. |
albumPosition |
مطلوبة. تمثّل هذه السمة الموضع في الألبوم الذي يتم فيه إدراج التفاصيل. |
نص الاستجابة
تمثّل هذه السمة عنصر التحسين الذي تم إنشاؤه.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"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 ستتم إضافة تحسين إلى الألبوم. قد يكون النص أو موقعًا جغرافيًا أو خريطة. يمكن أن يكون الحقل "enrichment " واحدًا فقط مما يلي: |
|
textEnrichment |
النص المطلوب إضافته إلى الألبوم |
locationEnrichment |
الموقع الذي ستتم إضافته إلى الألبوم. |
mapEnrichment |
خريطة ستتم إضافتها إلى الألبوم. |
TextEnrichment
معلومات مفيدة تتضمّن نصًا
تمثيل JSON |
---|
{ "text": string } |
الحقول | |
---|---|
text |
النص الخاص بعنصر التحسين هذا. |
LocationEnrichment
ميزة تحتوي على موقع جغرافي واحد
تمثيل JSON |
---|
{
"location": {
object ( |
الحقول | |
---|---|
location |
الموقع الجغرافي للسلع الغنية بصريًا هذه |
الموقع الجغرافي
تمثل موقعًا جغرافيًا.
تمثيل JSON |
---|
{
"locationName": string,
"latlng": {
object ( |
الحقول | |
---|---|
locationName |
اسم الموقع الجغرافي الذي سيتم عرضه |
latlng |
موضع الموقع على الخريطة. |
LatLng
يشير ذلك المصطلح إلى كائن يمثّل زوجًا من خط العرض/خط الطول. يتم التعبير عن ذلك كزوج من الزوجين لتمثيل خطوط الطول والعرض بالدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يرد خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضمن النطاق [-90.0، +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون ضمن النطاق [-180.0، +180.0]. |
MapEnrichment
خطة خاصة تتضمّن خريطة تُظهر المواقع الجغرافية لنقطة الانطلاق والوجهة
تمثيل JSON |
---|
{ "origin": { object ( |
الحقول | |
---|---|
origin |
الموقع الجغرافي لنقطة انطلاق هذه السلعة الغنية بصريًا. |
destination |
الموقع الجغرافي كوجهة لعرض هذا المنتج المفيد |
EnrichmentItem
هي عبارة عن عنصر مفيد.
تمثيل JSON |
---|
{ "id": string } |
الحقول | |
---|---|
id |
تشير هذه السمة إلى معرّف العنصر المفيد. |