تحميل وسائط

يمكنك استخدام Google My Business API لتحميل الوسائط بالطريقتين التاليتين:

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

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

لتحميل صور من عنوان URL ، يمكنك إجراء الاتصال التالي إلى Media.Create استخدام العناصر ذات الصلة category حسب الحاجة.

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 My Business API، يمكنك الاتصال أدناه 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"
       },
     }