jaka bylaby odzpowiedz Docs REST API?
- User
jaka bylaby odzpowiedz Docs REST API?
- Assistant
Odpowiedź z Google Docs REST API jest znacznie bardziej szczegółowa niż to, co możesz uzyskać za pomocą
DocumentApp.getBody().getText(). Zamiast prostego ciągu znaków, otrzymujesz pełny obiekt JSON reprezentujący całą strukturę dokumentu, włącznie ze stylami akapitów, formatowaniem tekstu, listami, tabelami i innymi elementami.Kluczową informacją, której szukasz dla nagłówków, jest pole
namedStyleTypew obiekcieparagraphStylekażdego akapitu.Przykład odpowiedzi Docs REST API dla dokumentu z nagłówkami
Załóżmy, że masz prosty dokument Google Docs o takiej strukturze:
[Tytuł Dokumentu: Mój Dokument Testowy] # Wstęp (Nagłówek 1) To jest treść wstępu. ## Podrozdział Pierwszy (Nagłówek 2) Akapit w podrozdziale.Wywołanie metody
Docs.Documents.get(docId)(w Apps Script) lub bezpośrednie zapytanie do API zwróci JSON, który w uproszczeniu dla tego fragmentu będzie wyglądał tak:{ "documentId": "YOUR_DOC_ID_HERE", "title": "Mój Dokument Testowy", "body": { "content": [ { "startIndex": 1, "endIndex": 2, // Zazwyczaj dla pustej linii lub końca dokumentu "sectionBreak": {} // Początek sekcji, często pomijany w prostych scenariuszach }, { "startIndex": 2, "endIndex": 15, // Indeks końca paragrafu (dla "Wstęp\n") "paragraph": { "elements": [ { "startIndex": 2, "endIndex": 8, "textRun": { "content": "Wstęp", "textStyle": {} // Tu byłyby informacje o pogrubieniu, kursywie itp. } }, { "startIndex": 8, "endIndex": 9, "textRun": { "content": "\n", // Nowa linia "textStyle": {} } } ], "paragraphStyle": { "namedStyleType": "HEADING_1", // <<< TO JEST KLUCZ DO NAGŁÓWKÓW "direction": "LEFT_TO_RIGHT", "indentFirstLine": {}, "indentStart": {}, "indentEnd": {}, "lineSpacing": 115, "spaceAbove": {}, "spaceBelow": {}, "alignment": "START", "avoidOrphanAndWidow": false } } }, { "startIndex": 15, "endIndex": 35, // Indeks końca paragrafu (dla "To jest treść wstępu.\n") "paragraph": { "elements": [ { "startIndex": 15, "endIndex": 35, "textRun": { "content": "To jest treść wstępu.\n", "textStyle": {} } } ], "paragraphStyle": { "namedStyleType": "NORMAL_TEXT", // <<< Zwykły tekst "direction": "LEFT_TO_RIGHT", "indentFirstLine": {}, "indentStart": {}, "indentEnd": {}, "lineSpacing": 115, "spaceAbove": {}, "spaceBelow": {}, "alignment": "START", "avoidOrphanAndWidow": false } } }, { "startIndex": 35, "endIndex": 59, // Indeks końca paragrafu (dla "Podrozdział Pierwszy\n") "paragraph": { "elements": [ { "startIndex": 35, "endIndex": 59, "textRun": { "content": "Podrozdział Pierwszy\n", "textStyle": {} } } ], "paragraphStyle": { "namedStyleType": "HEADING_2", // <<< Kolejny nagłówek "direction": "LEFT_TO_RIGHT", "indentFirstLine": {}, "indentStart": {}, "indentEnd": {}, "lineSpacing": 115, "spaceAbove": {}, "spaceBelow": {}, "alignment": "START", "avoidOrphanAndWidow": false } } }, { "startIndex": 59, "endIndex": 80, // Indeks końca paragrafu (dla "Akapit w podrozdziale.\n") "paragraph": { "elements": [ { "startIndex": 59, "endIndex": 80, "textRun": { "content": "Akapit w podrozdziale.\n", "textStyle": {} } } ], "paragraphStyle": { "namedStyleType": "NORMAL_TEXT", "direction": "LEFT_TO_RIGHT", "indentFirstLine": {}, "indentStart": {}, "indentEnd": {}, "lineSpacing": 115, "spaceAbove": {}, "spaceBelow": {}, "alignment": "START", "avoidOrphanAndWidow": false } } } // ... inne elementy dokumentu, takie jak listy, tabele itp. ] } }Kluczowe elementy odpowiedzi JSON dla nagłówków:
-
body.content: To jest główna tablica, która zawiera wszystkie elementy strukturalne dokumentu w kolejności. Każdy element w tej tablicy toStructuralElement. -
StructuralElement: Może to byćparagraph,tablelubsectionBreak. W przypadku tekstu i nagłówków interesuje nasparagraph. -
paragraph: Obiekt reprezentujący akapit. Zawiera:elements: TablicaParagraphElement. KażdyParagraphElementmoże byćtextRun(czyli fragmentem tekstu z określonym formatowaniem),inlineObjectElement(obraz, kształt),equationitd.paragraphStyle: Obiekt zawierający informacje o stylu całego akapitu.
-
paragraphStyle.namedStyleType: To jest kluczowe pole! Wskazuje, jaki styl "nazwany" jest zastosowany do akapitu."HEADING_1": Odpowiednik "Nagłówka 1""HEADING_2": Odpowiednik "Nagłówka 2"- ... do
"HEADING_6" "NORMAL_TEXT": Odpowiednik "Normalny tekst""TITLE","SUBTITLE": Dla tytułu i podtytułu dokumentu."LIST_ITEM": Dla elementów list.
-
textRun.content: Wewnątrzelementskażdegoparagraph, znajdziesztextRun. Jego polecontentzawiera faktyczny tekst danego fragmentu. Musisz iterować przez wszystkietextRunw danym paragrafie, aby odzyskać pełny tekst akapitu.
Jak to wykorzystać w Apps Script?
Tak jak wspomniałem w poprzedniej odpowiedzi, aby uzyskać ten JSON w Apps Script, musisz włączyć "Advanced Google Services" dla Google Docs API w swoim projekcie i użyć
Docs.Documents.get():function fetchDocContentWithHeadings(docId) { // Pamiętaj o włączeniu Docs API w Services (po lewej w projekcie Apps Script) // Oraz autoryzacji z zakresem https://www.googleapis.com/auth/documents.readonly try { const doc = Docs.Documents.get(docId, { fields: 'body.content,title' }); // Pobieramy tylko potrzebne pola Logger.log(JSON.stringify(doc, null, 2)); // Wypisujemy cały JSON do logów let markdownOutput = `# ${doc.title}\n\n`; // Zacznij od tytułu dokumentu doc.body.content.forEach(structuralElement => { if (structuralElement.paragraph) { const paragraph = structuralElement.paragraph; const namedStyleType = paragraph.paragraphStyle.namedStyleType; let paragraphText = ""; // Zbierz cały tekst z danego akapitu paragraph.elements.forEach(element => { if (element.textRun) { paragraphText += element.textRun.content; } // Można też obsługiwać inne typy elementów, np. inlineObjectElement dla obrazów }); // Usuń znaki nowej linii z końca, jeśli nie są częścią faktycznej treści paragraphText = paragraphText.trimEnd(); // Przetwórz na Markdown if (namedStyleType.startsWith("HEADING_")) { const level = parseInt(namedStyleType.replace("HEADING_", "")); markdownOutput += "#".repeat(level) + " " + paragraphText + "\n\n"; } else if (namedStyleType === "NORMAL_TEXT") { markdownOutput += paragraphText + "\n\n"; } else if (namedStyleType === "BULLET_LIST") { // Obsługa list jest bardziej skomplikowana i wymaga analizy listProperties. // Dla uproszczenia, można potraktować jako zwykły tekst lub rozbudować logikę. markdownOutput += "- " + paragraphText + "\n"; } // ... inne typy stylów } // Możesz też obsłużyć tabele (structuralElement.table) }); Logger.log("--- Markdown Output ---"); Logger.log(markdownOutput); return markdownOutput; } catch (e) { Logger.log("Błąd pobierania dokumentu: " + e.message); return null; } } // Przykład użycia: // const myDocId = "YOUR_GOOGLE_DOC_ID"; // fetchDocContentWithHeadings(myDocId);Ten skrypt pokazuje, jak iterować przez
content, sprawdzaćnamedStyleTypei rekonstruować tekst w formacie Markdown, który AI może łatwo zrozumieć. Jest to podejście dające pełną kontrolę nad tym, jak struktura dokumentu jest przekazywana do modelu LLM. -
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.