- طلب 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
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
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 |
معرّف السلعة الغنية بصريًا |