Skip to content
The Chat Archive
gemini-2.5-flash· Google LMArena Human Preference 140K

jaka bylaby odzpowiedz Docs REST API?

  1. User

    jaka bylaby odzpowiedz Docs REST API?

  2. 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 namedStyleType w obiekcie paragraphStyle każ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:

    1. body.content: To jest główna tablica, która zawiera wszystkie elementy strukturalne dokumentu w kolejności. Każdy element w tej tablicy to StructuralElement.

    2. StructuralElement: Może to być paragraph, table lub sectionBreak. W przypadku tekstu i nagłówków interesuje nas paragraph.

    3. paragraph: Obiekt reprezentujący akapit. Zawiera:

      • elements: Tablica ParagraphElement. Każdy ParagraphElement może być textRun (czyli fragmentem tekstu z określonym formatowaniem), inlineObjectElement (obraz, kształt), equation itd.
      • paragraphStyle: Obiekt zawierający informacje o stylu całego akapitu.
    4. 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.
    5. textRun.content: Wewnątrz elements każdego paragraph, znajdziesz textRun. Jego pole content zawiera faktyczny tekst danego fragmentu. Musisz iterować przez wszystkie textRun w 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ć namedStyleType i 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.

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.