Existe um padrão de projeto (Design Pattern) chamado fábrica (Factory).
Factory é um Design Pattern para criação de objetos.
A Factory sabe qual objeto criar de acordo com os parâmetros que ela recebe.
Logo, ao implementarmos esse padrão e tentar criar o objeto, internamente a Factory se encarrega de retornar o objeto, que pode ser diferente, dependendo dos parâmetros informados.
Nesse exemplo que você informou, ao criar o objeto usando new DriveConnection().ReturnDriveService().Files.Create(...)
, internamente a Factory ao receber os parâmetros pode retornar um objeto ou outro.
Exemplo (esse exemplo é apenas para entendimento básico de como um método poderia retornar mais de um tipo de objeto, mas se deseja saber mais detalhes sobre o padrão de projeto Factory dê uma olhada aqui):
Imagine que CreateMediaUpload
e CreateRequest
implementam a mesma interface chamada ICreate
. Vamos supor que existe uma classe que será a nossa Factory
com um método assim:
public ICreate Create(....)
{
// De acordo com os parâmetros, pode ser retornado um tipo CreateMediaUpload ou CreateRequest
}
Nesse exemplo, a Factory pode disponibilizar um método para criação de diferentes objetos que implementam a interface ICreate
.
Edição:
Outro exemplo onde um método pode retornar mais de um objeto diferente:
Imagine que a classe Files
abaixo disponibilize dois métodos Create
com parâmetros diferentes, dependendo dos parâmetros um tipo de objeto é retornado:
public class Files
{
public CreateMediaUpload Create(string fileMetadata, string stream, string imageType)
{
return new CreateMediaUpload(fileMetadata, stream, imageType);
}
public CreateRequest Create(CreateMediaUpload createMediaUpload)
{
return new CreateRequest(createMediaUpload);
}
}
Ao usar Files.Create(...)
apesar do nome do método ser Create
posso obter objetos diferentes.