Working with the term store

The term store is the managed-metadata service: a hierarchy of groups → sets → terms shared across SharePoint and OneDrive for consistent tagging. These examples build taxonomy, search it, export/import it, and clean up. Requires TermStore.ReadWrite.All (TermStore.Read.All to read).

Walk and create taxonomy

store = client.term_store.get().execute_query()
group = store.groups.add("Departments").execute_query()
term_set = store.sets.add("Geography", group.id).execute_query()
term = store.sets.get_by_id(term_set.id).children.add("EMEA").execute_query()

→ create_terms.py · search_term.py

Export / import the hierarchy

Round-trip the whole taxonomy to JSON — a backup, or a promotion between tenants.

tree = store.export_tree().execute_query().value  # serialize groups → sets → terms
store.import_tree(tree).execute_query()  # recreate it

→ export_store.py · export_tree.py · import_store.py

Clean up

for group in store.groups.get().execute_query():
    group.delete_object().execute_query()

→ clear_store.py