슬라이드 작업

Google Slides API를 사용하여 슬라이드를 만들고 이동하고 삭제할 수 있습니다. 이 페이지에서는 presentations.batchUpdate 메서드를 사용하여 축소하도록 요청합니다.

이 예에서는 다음 변수를 사용합니다.

  • PRESENTATION_ID: 프레젠테이션 ID를 입력합니다. 다음과 같은 작업을 할 수 있습니다. 이 ID에 대한 값을 검색합니다.
  • PAGE_ID 및 PAGE_ID2: 페이지 객체를 제공하여 ID를 입력합니다. 다음을 가져올 수 있습니다. 이 값에 대한 값을 URL에서 가져오거나 API 읽기 요청을 사용하여 가져올 수 있습니다.

이 예는 언어 중립을 위해 HTTP 요청으로 제공됩니다. 배우기 위해 Google API를 사용하여 다양한 언어로 일괄 업데이트를 구현하는 방법 자세한 내용은 다음 가이드를 참조하세요. 만들기 슬라이드와 도형 추가 및 텍스트를 사용합니다.

슬라이드 복사

다음 presentations.batchUpdate 코드 샘플을 사용하여 DuplicateObjectRequest 방법을 사용하여 슬라이드를 복사한 후 프레젠테이션에서 원본 뒤에 삽입할 수 있습니다. 원본 슬라이드는 PAGE_ID로 지정됩니다.

요청을 사용하면 페이지 요소 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 메서드를 사용하여 슬라이드를 만들고 네 번째 슬라이드로 삽입합니다 (0부터 시작하는 위치 선택). 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 메서드를 사용하여 두 개의 지정된 슬라이드를 상대적인 순서를 유지합니다.

지정된 슬라이드 ID (PAGE_ID 및 PAGE_ID2) 중복 없이 기존 프레젠테이션 순서로 제공되어야 합니다. 이 0부터 시작하는 insertionIndex은 이동이 이루어지기 전에 주문에 대한 세부정보를 변경할 수 있습니다 값은 0과 프레젠테이션의 슬라이드 수(포함)입니다.

다음은 슬라이드를 새 위치로 이동하는 요청 프로토콜입니다.

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

썸네일 생성

다음 위치에서 특정 페이지의 최신 버전에 대한 미리보기 이미지를 생성할 수 있습니다. 새 API를 호출하여 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"
}