บริการสไลด์ขั้นสูง

บริการสไลด์ขั้นสูงช่วยให้คุณเข้าถึง Slides API ได้โดยใช้ Apps Script บริการนี้ช่วยให้สคริปต์อ่านและแก้ไขเนื้อหาใน Google สไลด์ได้

นี่เป็นบริการขั้นสูงที่ต้องเปิดใช้ก่อนใช้งาน

ข้อมูลอ้างอิง

ดูข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ได้ในเอกสารอ้างอิงสำหรับ Slides API เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script บริการขั้นสูงของสไลด์จะใช้วัตถุ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ ดูข้อมูลเพิ่มเติมได้ที่วิธีกำหนดลายเซ็นของเมธอด

หากต้องการรายงานปัญหาและรับการสนับสนุนอื่นๆ โปรดดู คู่มือการสนับสนุนของสไลด์

โค้ดตัวอย่าง

ตัวอย่างโค้ดด้านล่างใช้ API เวอร์ชัน 1

สร้างงานนำเสนอใหม่

ตัวอย่างต่อไปนี้แสดงวิธีสร้างงานนำเสนอใหม่โดยใช้ บริการขั้นสูงของสไลด์ ซึ่งเทียบเท่ากับตัวอย่างสูตร สร้างงานนำเสนอใหม่

advanced/slides.gs

ดูใน GitHub

/**
 * Create a new presentation.
 * @return {string} presentation Id.
 * @see https://developers.google.com/slides/api/reference/rest/v1/presentations/create
 */
function createPresentation() {
  try {
    const presentation = Slides.Presentations.create({
      title: "MyNewPresentation",
    });
    console.log(`Created presentation with ID: ${presentation.presentationId}`);
    return presentation.presentationId;
  } catch (e) {
    // TODO (developer) - Handle exception
    console.log("Failed with error %s", e.message);
  }
}

สร้างสไลด์ใหม่

ตัวอย่างต่อไปนี้แสดงวิธีสร้างสไลด์ใหม่ในงานนำเสนอ ที่ดัชนีที่เฉพาะเจาะจงและมีเลย์เอาต์ที่กำหนดไว้ล่วงหน้า ซึ่งเทียบเท่ากับตัวอย่างสูตร สร้างสไลด์ใหม่

advanced/slides.gs

ดูใน GitHub

/**
 * Create a new slide.
 * @param {string} presentationId The presentation to add the slide to.
 * @return {Object} slide
 * @see https://developers.google.com/slides/api/reference/rest/v1/presentations/batchUpdate
 */
function createSlide(presentationId) {
  // You can specify the ID to use for the slide, as long as it's unique.
  const pageId = Utilities.getUuid();

  const requests = [
    {
      createSlide: {
        objectId: pageId,
        insertionIndex: 1,
        slideLayoutReference: {
          predefinedLayout: "TITLE_AND_TWO_COLUMNS",
        },
      },
    },
  ];
  try {
    const slide = Slides.Presentations.batchUpdate(
      { requests: requests },
      presentationId,
    );
    console.log(
      `Created Slide with ID: ${slide.replies[0].createSlide.objectId}`,
    );
    return slide;
  } catch (e) {
    // TODO (developer) - Handle Exception
    console.log("Failed with error %s", e.message);
  }
}

อ่านรหัสออบเจ็กต์องค์ประกอบของหน้า

ตัวอย่างต่อไปนี้แสดงวิธีดึงข้อมูลรหัสออบเจ็กต์สำหรับองค์ประกอบ ทุกหน้าในสไลด์ที่เฉพาะเจาะจงโดยใช้มาสก์ฟิลด์ ซึ่งเทียบเท่ากับตัวอย่างสูตรอ่านรหัสออบเจ็กต์ขององค์ประกอบจากหน้าเว็บ

advanced/slides.gs

ดูใน GitHub

/**
 * Read page element IDs.
 * @param {string} presentationId The presentation to read from.
 * @param {string} pageId The page to read from.
 * @return {Object} response
 * @see https://developers.google.com/slides/api/reference/rest/v1/presentations.pages/get
 */
function readPageElementIds(presentationId, pageId) {
  // You can use a field mask to limit the data the API retrieves
  // in a get request, or what fields are updated in an batchUpdate.
  try {
    const response = Slides.Presentations.Pages.get(presentationId, pageId, {
      fields: "pageElements.objectId",
    });
    console.log(response);
    return response;
  } catch (e) {
    // TODO (developer) - Handle Exception
    console.log("Failed with error %s", e.message);
  }
}

เพิ่มช่องข้อความใหม่

ตัวอย่างต่อไปนี้แสดงวิธีเพิ่มกล่องข้อความใหม่ลงในสไลด์และเพิ่มข้อความลงในกล่องข้อความ ซึ่งเทียบเท่ากับตัวอย่างสูตร เพิ่มกล่องข้อความลงในสไลด์

advanced/slides.gs

ดูใน GitHub

/**
 * Add a new text box with text to a page.
 * @param {string} presentationId The presentation ID.
 * @param {string} pageId The page ID.
 * @return {Object} response
 * @see https://developers.google.com/slides/api/reference/rest/v1/presentations/batchUpdate
 */
function addTextBox(presentationId, pageId) {
  // You can specify the ID to use for elements you create,
  // as long as the ID is unique.
  const pageElementId = Utilities.getUuid();

  const requests = [
    {
      createShape: {
        objectId: pageElementId,
        shapeType: "TEXT_BOX",
        elementProperties: {
          pageObjectId: pageId,
          size: {
            width: {
              magnitude: 150,
              unit: "PT",
            },
            height: {
              magnitude: 50,
              unit: "PT",
            },
          },
          transform: {
            scaleX: 1,
            scaleY: 1,
            translateX: 200,
            translateY: 100,
            unit: "PT",
          },
        },
      },
    },
    {
      insertText: {
        objectId: pageElementId,
        text: "My Added Text Box",
        insertionIndex: 0,
      },
    },
  ];
  try {
    const response = Slides.Presentations.batchUpdate(
      { requests: requests },
      presentationId,
    );
    console.log(
      `Created Textbox with ID: ${response.replies[0].createShape.objectId}`,
    );
    return response;
  } catch (e) {
    // TODO (developer) - Handle Exception
    console.log("Failed with error %s", e.message);
  }
}

จัดรูปแบบข้อความรูปร่าง

ตัวอย่างต่อไปนี้แสดงวิธีจัดรูปแบบข้อความของรูปร่าง อัปเดตสี แบบอักษร และขีดเส้นใต้ข้อความ ซึ่งเทียบเท่ากับตัวอย่างสูตร จัดรูปแบบข้อความในรูปร่างหรือกล่องข้อความ

advanced/slides.gs

ดูใน GitHub

/**
 * Format the text in a shape.
 * @param {string} presentationId The presentation ID.
 * @param {string} shapeId The shape ID.
 * @return {Object} replies
 * @see https://developers.google.com/slides/api/reference/rest/v1/presentations/batchUpdate
 */
function formatShapeText(presentationId, shapeId) {
  const requests = [
    {
      updateTextStyle: {
        objectId: shapeId,
        fields: "foregroundColor,bold,italic,fontFamily,fontSize,underline",
        style: {
          foregroundColor: {
            opaqueColor: {
              themeColor: "ACCENT5",
            },
          },
          bold: true,
          italic: true,
          underline: true,
          fontFamily: "Corsiva",
          fontSize: {
            magnitude: 18,
            unit: "PT",
          },
        },
        textRange: {
          type: "ALL",
        },
      },
    },
  ];
  try {
    const response = Slides.Presentations.batchUpdate(
      { requests: requests },
      presentationId,
    );
    return response.replies;
  } catch (e) {
    // TODO (developer) - Handle Exception
    console.log("Failed with error %s", e.message);
  }
}

แนวทางปฏิบัติแนะนำ

การอัปเดตเป็นกลุ่ม

เมื่อใช้บริการขั้นสูงของสไลด์ ให้รวมคำขอหลายรายการไว้ในอาร์เรย์ แทนการเรียก batchUpdate ในลูป

อย่า — เรียกใช้ batchUpdate ในลูป

var titles = ["slide 1", "slide 2"];
for (var i = 0; i < titles.length; i++) {
  Slides.Presentations.batchUpdate(preso, {
    requests: [{
      createSlide: ...
    }]
  });
}

ทำ - เรียกใช้ batchUpdate พร้อมอาร์เรย์ของการอัปเดต

var requests = [];
var titles = ["slide 1", "slide 2"];
for (var i = 0; i < titles.length; i++) {
  requests.push({ createSlide: ... });
}

Slides.Presentations.batchUpdate(preso, {
  requests: requests
});