عملیات ارائه

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

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

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

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

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

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

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

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

Slides API روشی را برای بازیابی لیستی از ارائه ها ارائه نمی دهد، اما Drive API ارائه می دهد. روش files.list (در زیر ارائه می‌شود) از ماسک‌های فیلد برای برگرداندن فهرستی از فایل‌های ارائه از Drive شما با شناسه فایل، نام فایل و پیوندی برای باز کردن فایل استفاده می‌کند. درخواست همچنین 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." جایگزین می شود. این شامل متن در جعبه‌های متن و اشکال دیگر، روی اسلایدها و در Master است. در این مثال، جایگزینی متن با تنظیم matchCase روی true به حروف بزرگ و کوچک حساس است.

در زیر پروتکل درخواست جایگزینی متن در سراسر ارائه آمده است: 

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}