عملیات ارائه

API اسلایدهای گوگل به شما امکان می‌دهد فایل‌های ارائه ایجاد کنید و فایل‌های موجود را مدیریت کنید. مثال‌های این صفحه برخی از عملیات رایج ارائه صفحه را با استفاده از متد presentations.batchUpdate نشان می‌دهند.

این مثال‌ها به عنوان درخواست‌های HTTP ارائه شده‌اند تا از نظر زبانی بی‌طرف باشند. برای یادگیری نحوه پیاده‌سازی به‌روزرسانی دسته‌ای در زبان‌های مختلف با استفاده از کتابخانه‌های کلاینت API گوگل، به راهنماهای زیر مراجعه کنید:

• ایجاد و مدیریت ارائه‌ها
• جستجو در فایل‌ها و پوشه‌ها
• ادغام داده‌ها در یک ارائه

ایجاد یک ارائه

نمونه کد presentations.create زیر نحوه ایجاد یک فایل ارائه خالی با عنوان "ارائه جدید من" را نشان می‌دهد.

همچنین می‌توان با استفاده از متد files.create از API گوگل درایو و با مشخص کردن application/vnd.google-apps.presentation به عنوان نوع MIME، فایل‌های ارائه خالی ایجاد کرد.

پروتکل درخواست برای ایجاد یک ارائه به شرح زیر است:

POST https://slides.googleapis.com/v1/presentations

{
  "title": "My New Presentation"
}

فهرست کردن فایل‌های ارائه موجود

API اسلایدها روشی برای بازیابی لیستی از ارائه‌ها ارائه نمی‌دهد، اما API درایو این کار را انجام می‌دهد. روش files.list (که در زیر ارائه شده است) از ماسک‌های فیلد برای بازگرداندن لیستی از فایل‌های ارائه از درایو شما، به همراه شناسه فایل، نام فایل و پیوندی برای باز کردن فایل استفاده می‌کند. این درخواست همچنین application/vnd.google-apps.presentation را به عنوان نوع MIME مشخص می‌کند.

پروتکل درخواست برای فهرست کردن فایل‌های ارائه موجود به شرح زیر است:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

پاسخ به این درخواست ساختار زیر را دارد:

{
 "files": [
    {
     "id": "abcdefghijklmnopqrstuvwxyz0123456789",
     "name": "Project Vision",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
    },
    {
     "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
     "name": "Untitled Presentation",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
    },
    ...
  ]
}

متن را در سراسر ارائه جایگزین کنید

نمونه کد presentations.batchUpdate زیر نحوه استفاده از متد ReplaceAllTextRequest را برای جایگزینی متن در سراسر ارائه مشخص شده توسط PRESENTATION_ID نشان می‌دهد. می‌توانید مقدار شناسه ارائه را از URL ارائه پیدا کنید.

هر نمونه از رشته "Gizmo Corp." با متن "Gadget Inc." جایگزین می‌شود. این شامل متن موجود در کادرهای متنی و سایر اشکال، روی اسلایدها و درون فایل‌های اصلی می‌شود. در این مثال، جایگزینی متن با تنظیم matchCase روی true ، به حروف کوچک و بزرگ حساس است.

پروتکل درخواست برای جایگزینی متن در طول یک ارائه به شرح زیر است:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}