Operacje na slajdach

Interfejs API Prezentacji Google umożliwia tworzenie, przenoszenie i usuwanie slajdów. Przykłady w na tej stronie można pokazać kilka typowych operacji na slajdach za pomocą funkcji presentations.batchUpdate .

W poniższych przykładach używane są te zmienne:

  • PRESENTATION_ID – wskazuje, gdzie podajesz atrybuty prezentacja Identyfikator. Dostępne opcje wartość tego identyfikatora można znaleźć w adresie URL prezentacji.
  • PAGE_ID i PAGE_ID2 – wskazuje, gdzie można podać obiekt strony identyfikatory. Możesz pobrać tę wartość z adresu URL lub za pomocą żądania odczytu interfejsu API.

Te przykłady są prezentowane jako żądania HTTP bez względu na język. Aby się uczyć Jak wdrożyć aktualizację zbiorczą w różnych językach przy użyciu interfejsu API Google? biblioteki klienta znajdziesz w tych przewodnikach: Tworzenie slajd i Dodaj kształty i tekst.

Kopiowanie slajdu

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z DuplicateObjectRequest w celu skopiowania slajdu i wstawienia go w prezentacji po oryginału. Oryginalny slajd jest określony przez atrybut PAGE_ID.

Żądanie pozwala określić, czy niektóre czy wszystkie identyfikatory elementów strony powinny być treść (z niektórymi ograniczenia). W tym przykładzie oryginalny slajd zawiera element tabeli (określony przez TABLE_ELEMENT_ID), która jest zmapowana na nową tabelę (określoną przez COPY_TABLE_ELEMENT_ID) w tekście slajdu (określanym przez COPY_PAGE_ID). Wszystkie pozostałe elementy w kopii są przypisywane losowo Identyfikatory.

Więcej informacji o kopiowaniu PageElement, takie jak pola tekstowe, obrazy, tabele, podstawowe kształty, linie i osadzone filmy, zobacz przykład Skopiuj i edytuj .

Oto protokół żądania do skopiowania slajdu:

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"
        }
      }
    }
  ]
}

Utwórz slajd

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z CreateSlideRequest aby utworzyć slajd i wstawić go jako czwarty slajd (za pomocą metody insertionIndex) w prezentacji.

Nowy slajd jest ustawiony tak, aby używać funkcji PredefinedLayout z TITLE_AND_TWO_COLUMNS. Możesz podać ciąg znaków, który będzie używany jako PAGE_ID za slajd (z ograniczenia), lub zezwól interfejsowi API na wygenerowanie PAGE_ID, pomijając pole do danego wniosku.

Oto protokół żądania do utworzenia slajdu:

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

Tworzenie slajdu i modyfikowanie obiektów zastępczych

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z CreateSlideRequest aby utworzyć slajd za pomocą PredefinedLayout z TITLE_AND_TWO_COLUMNS.

Możesz podać ciąg znaków, który będzie używany jako PAGE_ID w przypadku slajdu. (z pewnymi ograniczenia). placeholderIdMappings korzysta z funkcji Type z TITLE Element TITLE_ID odwołuje się do zastępczego kształtu slajdu więc można go zmodyfikować.

Poniżej znajduje się protokół żądań do tworzenia slajdów i modyfikowania obiektów zastępczych:

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",
      }
    },
  ]
}

Przenieś slajdy na nowe miejsce

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z UpdateSlidesPositionRequest aby przenieść te dwa określone slajdy na początek z zachowaniem ich względnej kolejności.

Określone identyfikatory slajdów (PAGE_ID i PAGE_ID2) należy podać w istniejącej kolejności prezentacji, bez duplikatów. od zera insertionIndex określa, gdzie powinny zostać wstawione slajdy, na podstawie zamówienia przed jego przeniesieniem. Wartość musi znajdować się w zakresie od 0 do włącznie z liczbą slajdów w prezentacji.

Następujący protokół żądania służy do przenoszenia slajdów do nowej pozycji:

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

Ustawianie obrazu tła slajdu

Poniżej presentations.batchUpdate przykładowy kod pokazuje, jak korzystać z UpdatePagePropertiesRequest metody ustawiania obrazu tła slajdu wskazanego przez PAGE_ID Interfejs API pobiera obraz za pomocą IMAGE_URL

Maska pola służy do określenia, że tylko tło slajdu należy zmienić, aby zachować pozostałe właściwości. Korzystanie z pola poprawiają też wydajność.

Można też użyć metody UpdatePagePropertiesRequest do ustawienia tło slajdu w jednolitym kolorze.

Oto protokół żądań ustawiania obrazu tła slajdu:

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

Wygeneruj miniaturę

Miniaturę najnowszej wersji konkretnej strony możesz wygenerować w prezentacji, używając funkcji presentations.pages.getThumbnail , która zwraca miniaturę strony jako adres URL treści. Obraz Domyślny czas trwania adresu URL to 30 minut.

Możesz również określić mimeType i thumbnailSize zwrócone za pomocą parametru ThumbnailProperties. jako parametr zapytania.

Poniżej znajduje się protokół żądania do generowania miniatury strony za pomocą tagu ThumbnailProperties seta:

 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"
}