OfficeIMO.Word.GoogleDocs 2.0.1

OfficeIMO.Word.GoogleDocs - Word to Google Docs export

OfficeIMO.Word.GoogleDocs builds translation plans and export requests for sending OfficeIMO.Word documents to Google Docs through OfficeIMO.GoogleWorkspace.

Install

dotnet add package OfficeIMO.Word.GoogleDocs

Quick start

using OfficeIMO.GoogleWorkspace;
using OfficeIMO.Word;
using OfficeIMO.Word.GoogleDocs;

using var document = WordDocument.Create("proposal.docx");
document.AddParagraph("Quarterly business review").SetStyle(WordParagraphStyles.Heading1);
document.AddParagraph("Highlights and next steps.");

var session = new GoogleWorkspaceSession(
    new StaticAccessTokenCredentialSource("<google-access-token>"),
    new GoogleWorkspaceSessionOptions {
        DefaultFolderId = "documents-folder-id",
        MaxRetryCount = 5,
        DiagnosticSink = entry => Console.WriteLine($"{entry.Severity}: {entry.Feature} - {entry.Message}")
    });

var options = new GoogleDocsSaveOptions {
    Title = "Quarterly business review"
};

var plan = document.BuildGoogleDocsPlan(options);
var result = await document.ExportToGoogleDocsAsync(session, options);

Console.WriteLine(result.DocumentId);
Console.WriteLine(result.WebViewLink);

What it does

• Builds a translation plan before network export.
• Exports to a new Google Docs document or replaces an existing document through Location.ExistingFileId.
• Uses session-level default Drive and folder placement.
• Preserves retry, warning, and failure detail through TranslationReport.
• Throws Google Workspace export exceptions that retain failure category and diagnostics.

Boundaries

• Word document modeling belongs in OfficeIMO.Word.
• Credentials, sessions, retry, Drive placement, and report primitives belong in OfficeIMO.GoogleWorkspace.
• This package owns Word-to-Google-Docs mapping and export request construction.

Targets and license

• Targets: netstandard2.0, net8.0, net10.0.
• License: MIT.
• Repository: EvotecIT/OfficeIMO

Dependency footprint

• External: System.Text.Json plus platform HTTP/cryptography through OfficeIMO.GoogleWorkspace; no Google client SDK.
• OfficeIMO: OfficeIMO.Word and OfficeIMO.GoogleWorkspace own the document model, session, translation plan, and reports.

See the complete OfficeIMO package map for related formats and conversion paths.