슬라이드 작업

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

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

  • PRESENTATION_ID: 프레젠테이션 ID를 입력합니다. 다음을 수행할 수 있습니다. 이 ID에 대한 값을 검색합니다.
  • PAGE_IDPAGE_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_IDPAGE_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분입니다.

다음을 사용하여 반환된 mimeTypethumbnailSize를 지정할 수도 있습니다. 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"
}