عملیات اسلاید

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

این نمونه ها از متغیرهای زیر استفاده می کنند:

  • PRESENTATION_ID — محل ارائه شناسه ارائه را نشان می دهد. می توانید مقدار این شناسه را از نشانی اینترنتی ارائه کشف کنید.
  • PAGE_ID و PAGE_ID2 — نشان می‌دهد که شناسه‌های شی صفحه را در کجا ارائه می‌دهید. می توانید مقدار این مورد را از URL یا با استفاده از درخواست خواندن API بازیابی کنید.

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

یک اسلاید را کپی کنید

نمونه کد presentations.batchUpdate زیر نحوه استفاده از روش DuplicateObjectRequest را برای کپی کردن یک اسلاید و درج آن بعد از نسخه اصلی در ارائه نشان می دهد. اسلاید اصلی توسط PAGE_ID مشخص شده است.

این درخواست به شما امکان می‌دهد مشخص کنید که برخی یا همه شناسه‌های عنصر صفحه باید در کپی باشند (با برخی محدودیت‌ها ). در این مثال، اسلاید اصلی حاوی یک عنصر جدول است (که توسط TABLE_ELEMENT_ID مشخص شده است)، که به یک جدول جدید (مشخص شده توسط COPY_TABLE_ELEMENT_ID ) در کپی اسلاید (مشخص شده توسط COPY_PAGE_ID ) نگاشت شده است. به تمام عناصر دیگر روی کپی شناسه های تصادفی داده می شود.

برای اطلاعات بیشتر در مورد کپی کردن یک PageElement ، از جمله کادرهای متن، تصاویر، جداول، اشکال اصلی، خطوط و ویدیوهای جاسازی شده، به نمونه کپی و ویرایش یک عنصر مراجعه کنید.

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

یک اسلاید ایجاد کنید

نمونه کد presentations.batchUpdate زیر نحوه استفاده از روش CreateSlideRequest را برای ایجاد یک اسلاید و درج آن به عنوان اسلاید چهارم (با استفاده از insertionIndex مبتنی بر صفر) در ارائه نشان می دهد.

اسلاید جدید برای استفاده از PredefinedLayout TITLE_AND_TWO_COLUMNS تنظیم شده است. می‌توانید رشته‌ای را برای استفاده به‌عنوان PAGE_ID برای اسلاید تعیین کنید (با برخی محدودیت‌ها )، یا به API اجازه دهید PAGE_ID با حذف فیلد در درخواست ایجاد کند.

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

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

نمونه کد presentations.batchUpdate زیر نحوه استفاده از روش CreateSlideRequest برای ایجاد یک اسلاید با استفاده از PredefinedLayout TITLE_AND_TWO_COLUMNS را نشان می دهد.

می‌توانید رشته‌ای را برای استفاده به عنوان PAGE_ID برای اسلاید تعیین کنید (با برخی محدودیت‌ها ). placeholderIdMappings از Type TITLE استفاده می کند. TITLE_ID به شکل مکان‌نمای اسلاید اشاره می‌کند تا بتوان آن را تغییر داد.

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

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

اسلایدها را به موقعیت جدیدی منتقل کنید

نمونه کد presentations.batchUpdate زیر نحوه استفاده از روش UpdateSlidesPositionRequest را برای گرفتن دو اسلاید مشخص شده و انتقال آنها به ابتدای ارائه و حفظ ترتیب نسبی آنها نشان می دهد.

شناسه های اسلاید مشخص شده ( PAGE_ID و PAGE_ID2 ) باید به ترتیب ارائه موجود، بدون تکرار ارائه شوند. insertionIndex مبتنی بر صفر، بر اساس ترتیب قبل از انجام حرکت، نشان‌دهنده جایی است که اسلایدها باید درج شوند. مقدار باید بین صفر و تعداد اسلایدها در ارائه باشد.

در زیر پروتکل درخواست برای انتقال اسلایدها به موقعیت جدید آمده است:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

یک تصویر پس زمینه اسلاید تنظیم کنید

نمونه کد presentations.batchUpdate زیر نحوه استفاده از روش UpdatePagePropertiesRequest را برای تنظیم تصویر پس‌زمینه یک اسلاید مشخص شده توسط PAGE_ID نشان می‌دهد. API تصویر را با استفاده از IMAGE_URL بازیابی می کند.

یک فیلد ماسک برای مشخص کردن این که فقط پس‌زمینه اسلاید باید تغییر کند تا سایر ویژگی‌ها حفظ شود، استفاده می‌شود. استفاده از ماسک های میدانی نیز عملکرد را بهبود می بخشد.

روش دیگر، می‌توان از روش UpdatePagePropertiesRequest برای تنظیم پس‌زمینه یک اسلاید به رنگ ثابت استفاده کرد.

در زیر پروتکل درخواست برای تنظیم یک تصویر پس زمینه اسلاید آمده است:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

ایجاد تصویر کوچک

می‌توانید با فراخوانی روش presentations.pages.getThumbnail یک تصویر کوچک از آخرین نسخه یک صفحه خاص در ارائه ایجاد کنید، که یک تصویر کوچک از صفحه را به عنوان URL محتوا برمی‌گرداند. طول عمر URL تصویر به طور پیش فرض 30 دقیقه است.

همچنین می‌توانید mimeType و thumbnailSize با استفاده از قسمت ThumbnailProperties به‌عنوان پارامتر پرس‌وجو مشخص کنید.

در زیر پروتکل درخواست برای ایجاد تصویر کوچک صفحه با مجموعه ThumbnailProperties است:

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}