In update_database_ddl() method docs it's said:

But looks like in fact in returns google.api_core.operation.Operation:

It's documented correctly in method Database.update_ddl(), which calls update_database_ddl() and returns it's return value:

It's the only place where update_database_ddl() is called, so I assume we can safely change return type in docs.