تحميل وسائط

يمكنك استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google" لتحميل الوسائط بالطريقتين التاليتين:

• التحميل من عنوان URL
• التحميل من وحدات البايت

التحميل من عنوان URL

لتحميل صور من عنوان URL، يجب إجراء الاتصال التالي على الرقم Media.Create. استخدِم الفئة المناسبة حسب الحاجة.

POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
{
  "mediaFormat": "PHOTO",
  "locationAssociation": {
    "category": "COVER"
  },
  "sourceUrl": “http://example.com/biz/image.jpg",
}

لتحميل فيديوهات من عنوان URL باستخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، يجب إجراء الاستدعاء التالي للرقم Media.Create:

POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
{
  "mediaFormat": "VIDEO",
  "locationAssociation": {
    "category": "ADDITIONAL"
  },
  "sourceUrl": “http://example.com/biz/video.mp4",
}

التحميل من وحدات بايت

لتحميل الوسائط من وحدات البايت باستخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، أكمِل الخطوات التالية:

ملاحظة: لا يتم دعم سوى تحميل الوسائط من وحدات البايت للمواقع الجغرافية. لتضمين الوسائط في مشاركة محلية، عليك تحميلها من عنوان URL.

1. لبدء التحميل، يمكنك إجراء الاتصال التالي:

     POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media:startUpload
     

   تعرض الاستجابة من واجهة برمجة التطبيقات نصًا يتضمّن MediaItemDataRef:

     {
     "resourceName": "GoogleProvidedValue",
     }

2. لتحميل وحدات البايت، استخدِم دالة resourceName التي عرضتها المكالمة التي تم إجراؤها في الخطوة السابقة. في ما يلي مثال يكون فيه الوسائط المطلوب تحميلها صورة:

   curl -X POST -T ~/Downloads/pictureToUpload.jpg  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"

   في ما يلي مثال إذا كانت الوسائط عبارة عن فيديو:

   curl -X POST -T ~/Downloads/videoToUpload.mp4  "https://mybusiness.googleapis.com/upload/v1/media/{GoogleProvidedValue}?upload_type=media"

3. استخدِم resourceName التي تم عرضها في الخطوة 1 لطلب رقم Media.Create. استخدِم السمتَين mediaFormat وcategory المناسبتَين.

     POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
     {
       "mediaFormat": "PHOTO",
       "locationAssociation": {
         "category": "COVER"
       },
       "dataRef": {
         "resourceName": "GoogleProvidedValue"
       },
     }

     POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media
     {
       "mediaFormat": "VIDEO",
       "locationAssociation": {
         "category": "ADDITIONAL"
       },
       "dataRef": {
         "resourceName": "GoogleProvidedValue"
       },
     }