このページは Cloud Translation API によって翻訳されました。

XML Service

このサービスを使用すると、スクリプトで XML ドキュメントを解析、ナビゲート、プログラムで作成できます。

// Log the title and labels for the first page of blog posts on
// Google's The Keyword blog.
function parseXml() {
  let url = 'https://blog.google/rss/';
  let xml = UrlFetchApp.fetch(url).getContentText();
  let document = XmlService.parse(xml);
  let root = document.getRootElement();

  let channel = root.getChild('channel');
  let items = channel.getChildren('item');
  items.forEach(item => {
    let title = item.getChild('title').getText();
    let categories = item.getChildren('category');
    let labels = categories.map(category => category.getText());
    console.log('%s (%s)', title, labels.join(', '));
  });
}

// Create and log an XML representation of first 10 threads in your Gmail inbox.
function createXml() {
  let root = XmlService.createElement('threads');
  let threads = GmailApp.getInboxThreads()
  threads = threads.slice(0,10); // Just the first 10
  threads.forEach(thread => {
    let child = XmlService.createElement('thread')
        .setAttribute('messageCount', thread.getMessageCount())
        .setAttribute('isUnread', thread.isUnread())
        .setText(thread.getFirstMessageSubject());
    root.addContent(child);
  });
  let document = XmlService.createDocument(root);
  let xml = XmlService.getPrettyFormat().format(document);
  console.log(xml);
}

クラス

名前	概要
`Attribute`	XML 属性の表現。
`Cdata`	XML `CDATASection` ノードの表現。
`Comment`	XML `Comment` ノードの表現。
`Content`	一般的な XML ノードの表現。
`ContentType`	XML コンテンツノードのタイプを表す列挙型。
`DocType`	XML `DocumentType` ノードの表現。
`Document`	XML ドキュメントの表現。
`Element`	XML `Element` ノードの表現。
`EntityRef`	XML `EntityReference` ノードの表現。
`Format`	XML ドキュメントを出力するためのフォーマッタ。3 つの事前定義された形式があり、さらにカスタマイズできます。
`Namespace`	XML 名前空間の表現。
`ProcessingInstruction`	XML `ProcessingInstruction` ノードの表現。
`Text`	XML `Text` ノードの表現。
`XmlService`	このサービスを使用すると、スクリプトで XML ドキュメントを解析、ナビゲート、プログラムで作成できます。

`Attribute`

メソッド

メソッド	戻り値の型	概要
`getName()`	`String`	属性のローカル名を取得します。
`getNamespace()`	`Namespace`	属性の名前空間を取得します。
`getValue()`	`String`	属性の値を取得します。
`setName(name)`	`Attribute`	属性のローカル名を設定します。
`setNamespace(namespace)`	`Attribute`	属性の名前空間を設定します。
`setValue(value)`	`Attribute`	属性の値を設定します。

`Cdata`

メソッド

メソッド	戻り値の型	概要
`append(text)`	`Text`	指定されたテキストを、ノード内にすでに存在するコンテンツに追加します。
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getText()`	`String`	`Text` ノードのテキスト値を取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。
`setText(text)`	`Text`	`Text` ノードのテキスト値を設定します。

`Comment`

メソッド

メソッド	戻り値の型	概要
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getText()`	`String`	`Comment` ノードのテキスト値を取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。
`setText(text)`	`Comment`	`Comment` ノードのテキスト値を設定します。

`Content`

メソッド

メソッド	戻り値の型	概要
`asCdata()`	`Cdata`	予測入力のためにノードを `CDATASection` ノードとしてキャストします。
`asComment()`	`Comment`	予測入力のためにノードを `Comment` ノードとしてキャストします。
`asDocType()`	`DocType`	予測入力のためにノードを `DocumentType` ノードとしてキャストします。
`asElement()`	`Element`	自動補完のためにノードを `Element` ノードとしてキャストします。
`asEntityRef()`	`EntityRef`	予測入力のためにノードを `EntityReference` ノードとしてキャストします。
`asProcessingInstruction()`	`ProcessingInstruction`	予測入力のためにノードを `ProcessingInstruction` ノードとしてキャストします。
`asText()`	`Text`	予測入力のためにノードを `Text` ノードとしてキャストします。
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getType()`	`ContentType`	ノードのコンテンツタイプを取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。

`ContentType`

プロパティ

プロパティ	タイプ	説明
`CDATA`	`Enum`	XML `CDATASection` ノード。
`COMMENT`	`Enum`	XML `Comment` ノード。
`DOCTYPE`	`Enum`	XML `DocumentType` ノード。
`ELEMENT`	`Enum`	XML `Element` ノード。
`ENTITYREF`	`Enum`	XML `EntityReference` ノード。
`PROCESSINGINSTRUCTION`	`Enum`	XML `ProcessingInstruction` ノード。
`TEXT`	`Enum`	XML `Text` ノード。

`DocType`

メソッド

メソッド	戻り値の型	概要
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getElementName()`	`String`	`DocType` 宣言で指定されたルート `Element` ノードの名前を取得します。
`getInternalSubset()`	`String`	`DocumentType` ノードの内部サブセットデータを取得します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getPublicId()`	`String`	`DocumentType` ノードの外部サブセットデータの公開 ID を取得します。
`getSystemId()`	`String`	`DocumentType` ノードの外部サブセットデータのシステム ID を取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。
`setElementName(name)`	`DocType`	`DocType` 宣言で指定するルート `Element` ノードの名前を設定します。
`setInternalSubset(data)`	`DocType`	`DocumentType` ノードの内部サブセットデータを設定します。
`setPublicId(id)`	`DocType`	`DocumentType` ノードの外部サブセットデータのパブリック ID を設定します。
`setSystemId(id)`	`DocType`	`DocumentType` ノードの外部サブセットデータのシステム ID を設定します。

`Document`

メソッド

メソッド	戻り値の型	概要
`addContent(content)`	`Document`	指定されたノードをドキュメントの末尾に追加します。
`addContent(index, content)`	`Document`	ドキュメントの直下の子であるすべてのノードのうち、指定されたインデックスに指定されたノードを挿入します。
`cloneContent()`	`Content[]`	ドキュメントの直接の子であるすべてのノードのアタッチされていないコピーを作成します。
`detachRootElement()`	`Element`	ドキュメントのルート `Element` ノードを切断して返します。
`getAllContent()`	`Content[]`	ドキュメントの直接の子であるすべてのノードを取得します。
`getContent(index)`	`Content`	ドキュメントの直下の子であるすべてのノードのうち、指定されたインデックスのノードを取得します。
`getContentSize()`	`Integer`	ドキュメントの直接の子であるノードの数を取得します。
`getDescendants()`	`Content[]`	ドキュメントの直接または間接の子であるすべてのノードを、ドキュメントに表示される順序で取得します。
`getDocType()`	`DocType`	ドキュメントの `DocType` 宣言を取得します。
`getRootElement()`	`Element`	ドキュメントのルート `Element` ノードを取得します。
`hasRootElement()`	`Boolean`	ドキュメントにルート `Element` ノードがあるかどうかを判断します。
`removeContent()`	`Content[]`	ドキュメントの直接の子であるすべてのノードを削除します。
`removeContent(content)`	`Boolean`	指定されたノードがドキュメントの直接の子である場合、そのノードを削除します。
`removeContent(index)`	`Content`	ドキュメントの直接の子であるすべてのノードのうち、指定されたインデックスのノードを削除します。
`setDocType(docType)`	`Document`	ドキュメントの `DocType` 宣言を設定します。
`setRootElement(element)`	`Document`	ドキュメントのルート `Element` ノードを設定します。

`Element`

メソッド

メソッド	戻り値の型	概要
`addContent(content)`	`Element`	指定されたノードを `Element` ノードの最後の子として追加します。
`addContent(index, content)`	`Element`	指定したノードを、`Element` ノードの直下の子であるすべてのノードの指定したインデックスに挿入します。
`cloneContent()`	`Content[]`	{@code Element} ノードの直下の子であるすべてのノードの、アタッチされていないコピーを作成します。
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getAllContent()`	`Content[]`	{@code Element} ノードの直接の子であるすべてのノードを取得します。
`getAttribute(name)`	`Attribute`	指定された名前で、名前空間のないこの `Element` ノードの属性を取得します。
`getAttribute(name, namespace)`	`Attribute`	指定された名前と名前空間を持つこの `Element` ノードの属性を取得します。
`getAttributes()`	`Attribute[]`	この `Element` ノードのすべての属性を、ドキュメントに記載されている順序で取得します。
`getChild(name)`	`Element`	指定された名前で、この `Element` ノードの直下の子ノードである Namespace のない最初の `Element` ノードを取得します。
`getChild(name, namespace)`	`Element`	この `Element` ノードの直下の子で、指定された名前と名前空間を持つ最初の `Element` ノードを取得します。
`getChildText(name)`	`String`	ノードが `Element` ノードの直下の子である場合、指定された名前と名前空間のないノードのテキスト値を取得します。
`getChildText(name, namespace)`	`String`	ノードが `Element` ノードの直下にある場合、指定された名前と名前空間を持つノードのテキスト値を取得します。
`getChildren()`	`Element[]`	この `Element` ノードの直下の子であるすべての `Element` ノードを、ドキュメント内の表示順で取得します。
`getChildren(name)`	`Element[]`	指定された名前で、この `Element` ノードの直下の子である名前空間のないすべての `Element` ノードを、ドキュメントに表示される順序で取得します。
`getChildren(name, namespace)`	`Element[]`	この `Element` ノードの直下の子で、指定された名前と名前空間を持つすべての `Element` ノードを、ドキュメントに表示される順序で取得します。
`getContent(index)`	`Content`	{@code Element} ノードの直接の子であるすべてのノードのうち、指定されたインデックスのノードを取得します。
`getContentSize()`	`Integer`	{@code Element} ノードの直下の子ノードの数を取得します。
`getDescendants()`	`Content[]`	{@code Element} ノードの直接または間接の子であるすべてのノードを、ドキュメントに表示される順序で取得します。
`getDocument()`	`Document`	{@code Element} ノードを含む XML ドキュメントを取得します。
`getName()`	`String`	`Element` ノードのローカル名を取得します。
`getNamespace()`	`Namespace`	`Element` ノードの Namespace を取得します。
`getNamespace(prefix)`	`Namespace`	`Element` ノードに指定された接頭辞を持つ名前空間を取得します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getQualifiedName()`	`String`	`Element` ノードのローカル名と名前空間の接頭辞を `[namespacePrefix]:[localName]` 形式で取得します。
`getText()`	`String`	`Element` ノードのテキスト値を取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。
`isAncestorOf(other)`	`Boolean`	この `Element` ノードが、特定の `Element` ノードの直接的または間接的な親であるかどうかを判断します。
`isRootElement()`	`Boolean`	`Element` ノードがドキュメントのルートノードかどうかを判断します。
`removeAttribute(attribute)`	`Boolean`	この `Element` ノードの指定された属性を削除します（存在する場合）。
`removeAttribute(attributeName)`	`Boolean`	指定された名前で名前空間のないこの `Element` ノードの属性を削除します（そのような属性が存在する場合）。
`removeAttribute(attributeName, namespace)`	`Boolean`	指定された名前と名前空間を持つこの `Element` ノードの属性を削除します（属性が存在する場合）。
`removeContent()`	`Content[]`	{@code Element} ノードの直接の子であるすべてのノードを削除します。
`removeContent(content)`	`Boolean`	指定されたノードが {@code Element} ノードの直接の子である場合、そのノードを削除します。
`removeContent(index)`	`Content`	{@code Element} ノードの直接の子であるすべてのノードのうち、指定したインデックスのノードを削除します。
`setAttribute(attribute)`	`Element`	この `Element` ノードに指定された属性を設定します。
`setAttribute(name, value)`	`Element`	指定された名前と値で、この `Element` ノードの属性を設定し、名前空間は設定しません。
`setAttribute(name, value, namespace)`	`Element`	指定された名前、値、Namespace を使用して、この `Element` ノードの属性を設定します。
`setName(name)`	`Element`	`Element` ノードのローカル名を設定します。
`setNamespace(namespace)`	`Element`	`Element` ノードの Namespace を設定します。
`setText(text)`	`Element`	`Element` ノードのテキスト値を設定します。

`EntityRef`

メソッド

メソッド	戻り値の型	概要
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getName()`	`String`	`EntityReference` ノードの名前を取得します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getPublicId()`	`String`	`EntityReference` ノードの公開 ID を取得します。
`getSystemId()`	`String`	`EntityReference` ノードのシステム ID を取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。
`setName(name)`	`EntityRef`	`EntityReference` ノードの名前を設定します。
`setPublicId(id)`	`EntityRef`	`EntityReference` ノードの公開 ID を設定します。
`setSystemId(id)`	`EntityRef`	`EntityReference` ノードのシステム ID を設定します。

`Format`

メソッド

メソッド	戻り値の型	概要
`format(document)`	`String`	指定された `Document` をフォーマットされた文字列として出力します。
`format(element)`	`String`	指定された `Element` ノードをフォーマットされた文字列として出力します。
`setEncoding(encoding)`	`Format`	フォーマッタが使用する文字エンコードを設定します。
`setIndent(indent)`	`Format`	親ノードに対して子ノードをインデントするために使用される文字列を設定します。
`setLineSeparator(separator)`	`Format`	フォーマッタが通常改行を挿入するときに挿入する文字列を設定します。
`setOmitDeclaration(omitDeclaration)`	`Format`	フォーマッタが XML 宣言（`<?xml version="1.0" encoding="UTF-8"?>` など）を省略するかどうかを設定します。
`setOmitEncoding(omitEncoding)`	`Format`	フォーマッタが XML 宣言のエンコード（`<?xml version="1.0" encoding="UTF-8"?>` のエンコードフィールドなど）を省略するかどうかを設定します。

`Namespace`

メソッド

メソッド	戻り値の型	概要
`getPrefix()`	`String`	名前空間の接頭辞を取得します。
`getURI()`	`String`	Namespace の URI を取得します。

`ProcessingInstruction`

メソッド

メソッド	戻り値の型	概要
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getData()`	`String`	`ProcessingInstruction` ノード内のすべての命令の元データを取得します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getTarget()`	`String`	`ProcessingInstruction` ノードのターゲットを取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。

`Text`

メソッド

メソッド	戻り値の型	概要
`append(text)`	`Text`	指定されたテキストを、ノード内にすでに存在するコンテンツに追加します。
`detach()`	`Content`	ノードを親の `Element` ノードから切断します。
`getParentElement()`	`Element`	ノードの親 `Element` ノードを取得します。
`getText()`	`String`	`Text` ノードのテキスト値を取得します。
`getValue()`	`String`	ノードの直接の子または間接の子であるすべてのノードのテキスト値を、ドキュメントに表示される順序で取得します。
`setText(text)`	`Text`	`Text` ノードのテキスト値を設定します。

`XmlService`

プロパティ

プロパティ	タイプ	説明
`ContentTypes`	`ContentType`	XML コンテンツノードのタイプを表す列挙型。

メソッド

メソッド	戻り値の型	概要
`createCdata(text)`	`Cdata`	指定された値を使用して、接続されていない `CDATASection` ノードを作成します。
`createComment(text)`	`Comment`	指定された値を使用して、接続されていない `Comment` ノードを作成します。
`createDocType(elementName)`	`DocType`	指定された名前のルート `Element` ノードに、アタッチされていない `DocumentType` ノードを作成します。
`createDocType(elementName, systemId)`	`DocType`	指定された名前のルート `Element` ノードと、外部サブセットデータの指定されたシステム ID を持つ、接続されていない `DocumentType` ノードを作成します。
`createDocType(elementName, publicId, systemId)`	`DocType`	指定された名前のルート `Element` ノードと、外部サブセットデータの指定された公開 ID とシステム ID を持つ、接続されていない `DocumentType` ノードを作成します。
`createDocument()`	`Document`	空の XML ドキュメントを作成します。
`createDocument(rootElement)`	`Document`	指定されたルート `Element` ノードを持つ XML ドキュメントを作成します。
`createElement(name)`	`Element`	指定されたローカル名で、Namespace のないアタッチされていない `Element` ノードを作成します。
`createElement(name, namespace)`	`Element`	指定されたローカル名と Namespace を使用して、アタッチされていない `Element` ノードを作成します。
`createText(text)`	`Text`	指定された値を使用して、接続されていない `Text` ノードを作成します。
`getCompactFormat()`	`Format`	コンパクトな XML ドキュメントを出力する `Format` オブジェクトを作成します。
`getNamespace(uri)`	`Namespace`	指定された URI で `Namespace` を作成します。
`getNamespace(prefix, uri)`	`Namespace`	指定された接頭辞と URI を使用して `Namespace` を作成します。
`getNoNamespace()`	`Namespace`	実際の名前空間がないことを示す `Namespace` を作成します。
`getPrettyFormat()`	`Format`	人間が読み取れる XML ドキュメントを出力するための `Format` オブジェクトを作成します。
`getRawFormat()`	`Format`	未加工の XML ドキュメントを出力する `Format` オブジェクトを作成します。
`getXmlNamespace()`	`Namespace`	標準の `xml` 接頭辞を使用して `Namespace` を作成します。
`parse(xml)`	`Document`	XML を検証せずに、指定された XML から `Document` を作成します。

XML Service コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

クラス

メソッド

メソッド

メソッド

メソッド

プロパティ

メソッド

メソッド

メソッド

メソッド

メソッド

メソッド

メソッド

メソッド

プロパティ

メソッド

XML Service