REST Resource: accounts.locations.media.customers

المرجع: MediaItem

ملف وسائط واحد

تمثيل JSON 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
الحقول
name

string

اسم المورد لعنصر الوسائط هذا. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

تمثّل هذه السمة تنسيق عنصر الوسائط هذا. يجب ضبطها عند إنشاء عنصر الوسائط، وأن تكون متاحة للقراءة فقط في جميع الطلبات الأخرى. لا يمكن تعديلها.
locationAssociation

object (LocationAssociation)

مطلوب عند الاتصال برقم CreatePhoto. يصف كيفية ارتباط عنصر الوسائط هذا بموقعه. يجب أن تكون فئة (على سبيل المثال، EXTERIOR) أو رقم تعريف لعنصر في قائمة الأسعار.

هذا الإجراء مطلوب عند إضافة وسائط جديدة إلى موقع جغرافي باستخدام media.create. وبالنسبة إلى أنواع الوسائط الأخرى، مثل الصور المنشورة في المشاركات المحلية، لن يتم عرض هذه البيانات.
googleUrl

string

النتائج فقط. عنوان URL الذي تستضيفه Google لعنصر الوسائط هذا. عنوان URL هذا ليس ثابتًا لأنّه قد يتغيّر بمرور الوقت. بالنسبة إلى الفيديو، ستكون هذه الصورة معاينة مع رمز تشغيل مركّب.
thumbnailUrl

string

النتائج فقط. عنوان URL لصورة مصغّرة لعنصر الوسائط هذا، في حال توفّره.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء عنصر الوسائط هذا

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
dimensions

object (Dimensions)

النتائج فقط. الأبعاد (العرض والارتفاع) بالبكسل.
insights

object (MediaInsights)

النتائج فقط. إحصاءات لعنصر الوسائط هذا.
attribution

object (Attribution)

النتائج فقط. معلومات تحديد المصدر لعناصر وسائط العملاء يجب عرض هذه الإسناد على النحو المقدَّم للمستخدمين، ويجب عدم حذف الإسناد أو تغييره.
description

string

وصف عنصر الوسائط هذا. ولا يمكن تعديل الأوصاف من خلال واجهة برمجة تطبيقات "نشاطي التجاري على Google"، ولكن يمكن ضبطها عند إنشاء عنصر وسائط جديد ليس صورة غلاف.

حقل الاتحاد data مصدر بيانات عنصر الوسائط. عند إنشاء عنصر وسائط جديد، يجب تقديم عنوان URL أو مرجع بيانات.

باستثناء الفئتَين PROFILE وCOVER، يجب أن يكون حجم جميع الصور لا يقل عن 250 بكسل على الحافة القصيرة، وأن يكون حجم الملف 10240 بايت على الأقل.

يجب أن تتوافق جميع الصور المحمَّلة مع إرشادات "الملف التجاري على Google" للصور. يمكن أن تكون السمة "data" واحدة فقط مما يلي:
sourceUrl

string

عنوان URL متاح للجميع ويمكن استرداد عنصر الوسائط منه.

عند إنشاء عنصر من هذه السمة أو dataRef، يجب ضبطهما لتحديد مصدر عنصر الوسائط.

إذا تم استخدام sourceUrl عند إنشاء عنصر وسائط، ستتم تعبئته بعنوان URL المصدر هذا عند استرداد عنصر الوسائط.

لا يمكن تعديل هذا الحقل.
dataRef

object (MediaItemDataRef)

الإدخال فقط. مرجع إلى البيانات الثنائية لعنصر الوسائط وفقًا لما تم الحصول عليه باستخدام طريقة media.startUpload.

عند إنشاء عنصر وسائط، يجب إما

sourceUrl

أو

dataRef

يجب تعيينها.

الطُرق

get

 تعرض البيانات الوصفية لعنصر الوسائط المطلوب للعميل.

list

 تعرض قائمة بوسائل الإعلام المرتبطة بموقع جغرافي ساهم به العملاء.