Etiqueta: .NET core

  • Tutorial Google APIs – Crear Proyecto en Google Cloud

    Aquí tienes la primera entrega del tutorial sobre el uso de las APIs de Google para acceder a Drive, Contactos y Documentos.

    Si quieres crer una cuenta y un proyecto para poder acceder a esos APIs de Google, lo primero es acceder a Google Cloud Platform y crear una cuenta, o mejor dicho, activarla con Google Cloud.

    Una vez que tengas la cuenta, tendrás que crear un proyecto y configurarlo para que pueda acceder a esas APIs.

    En este tutorial te explico paso a paso cómo hacerlo, y con un montón de capturas para que no te líes y yo no me olvide de contarte los paso, que todo hay que decirlo. 🙂

    Nota:
    Por ahora te voy dejar las capturas y en otra ocasión, si hace falta, te explico lo que cada captura significa.
    Es que quiero pasar a mostrarte el código para acceder al API de People (contactos) que ya lo tengo hecho tanto con C# como con Visual Basic.

    Figura 1. Crear un nuevo proyecto

     

    Figura 2.

     

    Figura 3.

     

    Figura 4.

     

    Figura 5.

     

    Figura 6. En la ficha G Suite están las de Docs API y drive API

     

    Figura 7. Tienes que elegir y habilitar una por una.

     

    Figura 8.

     

    Figura 9. Añadir más librerías (bibliotecas)

     

    Figura 10. Elige People API. No elijas Contacts API, que aparte de estar obsoleta, no vale para nada…

     

    Figura 11. Esta es la parte más importnte, sin la autorización OAuth no podrás acceder a nada.

     

    Figura 12. Siempre debe ser External

     

    Figura 13.

     

    Figura 14.

     

    Figura 15. Añadir las características que tu aplicación usará de cada API que has añadido.

     

    Figura 16.

     

    Figura 17.

    Nota:
    Los permisos debes ir probándolos a ver qué error te da, según lo que quieras hacer.
    Pero básicamente necesitas acceso de lectura, salvo que quieras modificar un contacto, un documento o algún fichero del Drive.

    Figura 18. No te olvides de darle a UPDATE ya que al estar tan abajo en la pantalla emergente ni se ve, y so no le das a Update, no se guardan los cambios.

     

    Figura 19.

     

    Figura 20.

     

    Figura 21. Aquí tienes que añadir los usuarios autorizados para que usen la aplicación. El máximo es 100 y una vez que aades uno, ya no lo puedes eliminar.

     

    Figura 22.

     

    Figura 23. Los tipos de credenciales que crearemos

     

    Figura 24.

     

    Figura 25. Estas so las APIs que usaremos con este proyecto.

     

    Figura 26. El tipo de aplicación que vamos a crear.

     

    Figura 27.

     

    Figura 28. Estas son las dos claves que necesitarás en tu código

     

    Figura 29.

     

    Figura 30.

     

    Figura 31. Si no hs copiado las credenciales de acceso, descarga el fichero .json y ahí las tienes.

     

     

    Pues esto es todo lo que debes saber para crear un proyecto.
    En la siguiente entrega voy a mostrarte el código de una aplicación de consola para acceder a los contactos (People API). Sí, en C# y en VB.

     

     

    Nos vemos.
    Guillermo

  • Tutorial para usar las APIs de Google con C# y Visual Basic

    Pues eso… que como yo me he encontrado con problemas a la hora de implementar las APIs de Google y de encontrar ejemplos (que de haberlos solo eran para C#), me he decido a escribir esta especie de tutorial para poder acceder a las siguientes APIs de Google: Drive, Docs y People. Es decir, poder manipular el contenido de Google Drive, los documentos y los contactos de Google que están asociados tu cuenta (o la cuenta que decidas usar) de GMail.

    Lo primero que necesitas (salvo que uses las que yo voy a crear para este tutorial) es crearte una cuenta en Google Cloud Platform, es gratuito al menos sino usas recursos que son de pago.
    La cuenta a usar será la que tengas ya de GMail o bien puedes crear una nueva cuenta y asociarla con Google Cloud.

    Cuandoi asocias una cuenta por primera vez, te darán una oferta de 300$ (US $) para que pruebes de forma gratuita los recursos de pago (siempre que no te pases de esos 300 dólares). Pero como te digo, para las cosas que te voy a explicar no te hace falta.

    Por ahora me voy a saltar el paso de crear tus propios poyectos en Google Cloud, eso lo dejaré para el final (salvo que cambie de opinión), lo que sí te digo es que si quieres utilizar los ejemplos que te voy a mostrar usando mis claves o las que yo indique en el código) antes debes decírmelo para poder añadir tu correo de GMail a los usuarios que pueden usar esas claves.

    Esto ultimo lo puedes hacer dejando un comentario en este mismo post y yo te agregaré, esto puede que no lo haga pasado unos meses, ya que solo quiero que la gente lo pruebe en este tiempo reciente, mientras publico los tutoriales. Y dejando, como mucho, unos tres meses de desde la publicación original, así que… si estás leyendo este tutorial después del 15 de marzo de 2021, es posible que o bien no admita más usuarios o simplemente que no lo siga «soportando», además de que hay un límite de 100 usuarios por proyecto, y si ya están esos usuarios registrados con la aplciación, es posible que, incluso antes del 15 de marzo del 2021 no pueda admitir más usuarios.

    Dicho esto, empecemos.

    Nota:
    Los ejemplos los voy a hacer con .NET 5.0.1 pero son válidos para .NET Framework v4.5 y superiores, .NET Standard y .NET Core.

    Crear un proyecto en C# o Visual Basic

    Crea un proyecto de consola para C# o VB y ve a Tools>NuGet Package Manager>Manage NuGet Packages for Solution… (en español es: Herramientas>Administrador de paquetes NuGet>Administrar paquetes NuGet para la solución…)

    Busca y añade los siguientes paquetes de NuGet (entre paréntesis te indico las versiones que estoy usando al escribir este tutorial):

    Nota:
    Los enlaces son por si quieres ir a la página de NuGet y descargarlas desde allí o ver cómo instalarlas según estés usando Visual Studio 2019 o Visual Studio Code o simplemente creando los proyectos desde la consola con dotnet.
    Eso sí, necesitarás tener instlado el SDK de dotnet 5 para poder compilar el código.

    Esto añadirá las referencias necesarias para usar el código que te mostraré.

    Nota:
    Si te interesa ver el código fuente de las APIs de google puedes verlas en el siguiente enlace: google-api-dotnet-client.

    Las entregas

    1. Entrega 1: Crear Proyecto en Google Cloud
    2. Entrega 2: Código para acceder a los contactos con People API
    3. Entrega 3: Código para acceder a los documentos con Drive API y Docs API
    4. Entrega 4: Código para crear un documento con Docs API

    Nota:
    Voy a publicar ahora este post mientras creo el protyecto de prueba, escribo el código, lo convierto de C# a VB (ya tengo código escrito en C#) y lo publico, así podrás solicitar tu «permiso» para usar estos ejemplos con mi ID y clave secreta (que después de publicarla no será tan secreta 😉 )

    Nos vemos.
    Guillermo

  • Escribir código en C#. Guía para los developers de Visual Basic

    Pues eso… Ahora que estoy empezando a escribir más programas en C# me doy cuenta de que esto de poner al final de cada sentencia un punto y coma es un poco engorroso. La idea sería que cuando se escribe una línea en C# al pulsar intro en el IDE de Visual Studio automáticamente le agregara el punto y coma al final. Esto lo he puesto como sugerencia en la Developer Community a ver si hacen caso, aunque no sé yo… si quieres ver esa sugerencia (Add automatically the semicolon (;) at the end when writing a new sentence in C# ), sigue el enlace.

    Lo que si me he dado cuenta, o más bien, he confirmado, es que salvo excepciones y algunas características propias, escribir código en C# es casi como en Visual Basic. Por supuesto, si escribes una array debes usar corchetes [] en vez de paréntesis (), debes agregarle a todos los métodos sin parámetros los paréntesis al final, o la forma de escribir un simple if, tienes que acostumbrarte a poner entre paréntesis lo que vayas a comprobar con ese if.

    Después hay cosas que son más raras (C# y otros lenguajes de la misma familia son expertos en esas rarezas que la gente de Visual Basic vemos como ganas de complicarse la vida, jejeje, pero bueno, es cuestión de ir acostumbrándose) por ejemplo el operador ternario de C# que en Visual Basic lo escribimos como un If(comprobación, valor si true, valor si false):

    Dim s = If( valor, "Es True", "Es False")
    dim s = if(valor,  "Es True" , "Es False")

    en C# hay que hacerlo así:

    var s = valor ? "Es True" : "Es False";
    var s = valor ? "Es True" : "Es False";

    Esto asigna a la variable s lo que corresponda, dependiendo de que la variable valor contenga un valor verdadero o falso.

    Viendo el código de VB que te acabo de poner, parece que me contradigo con lo que he comentado de los ifs de C# (que hay que ponerlo entre paréntesis) pero es que este If que he usado en VB es un If especial, y sirve para lo que acabo de explicarte.

    Si queremos usar un If normal podríamos hacerlo de la siguiente forma:

    Dim s = ""
    If valor Then
        s = "Es True"
    Else
        s = "Es False"
    End If
    Dim s = ""
    If valor Then
        s = "Es True"
    Else
        s = "Es False"
    End If
    

    En C# sería algo así (se puede escribir con o sin llaves {}:

    var s = "";
    if( valor )
        s = "Es True";
    else
        s = "Es False";
    var s = "";
    if( valor )
        s = "Es True";
    else
        s = "Es False";
    

    De esta forma, es para cuando después del if o del else solo hay una instrucción, si queremos poner más de una instrucción, debemos usar las llaves:

    var s = "";
    if( valor )
    {
        s = "Es True";
    }
    else
    {
        s = "Es False";
    }
    var s = "";
    if (valor)
    {
        s = "Es True";
    }
    else
    {
        s = "Es False";
    }
    

    Y así… más cosas… como los bucles for, etc.

    No voy a seguir porque no es plan de hacer un curso de cómo hacer las cosas en los dos lenguajes, de todas formas, en mi sitio (www.elguille.info) y en este blog los ejemplos de código que pongo los tengo en los dos lenguajes.

    Y si te interesa saber algunas de las equivalencias entre Visual Basic .NET y C# las puedes encontrar en esta página (en realidad son 3 páginas de equivalencias):

    Equivalencias entre VB.NET y C# (1) (elguille.info)

    Equivalencias entre Visual Basic para .NET y C# (2) (elguille.info)

    Equivalencias entre Visual Basic para .NET y C# (3) (elguille.info)

    En otro momento le echaré un vistazo al contenido completo y veré si añado nuevas cosas, que las hay… ya que la última página la publiqué el 6 de agosto de 2006 y desde entonces (en estos más de 14 años) han salido cosas nuevas que hay que equiparar 😉 

    Y esto es todo por ahora… mañana más (u otro día más).

    Nos vemos.
    Guillermo

    #evolveVB #evolucionarVB

    P.S.
    Escrito en documentos de Google, intentando usar el dictado por voz, pero se ve que no me entiende tan bien o al menos no es mejor de lo que me esperaba… ya que parte de ese texto lo escribí usando Keep y dictándolo, pero como no había forma de añadir los puntos, coma, etc., he intentado con los documentos en la web usando Chrome.
    Seguiré intentándolo… como con C#, a base de probar y probar al final se consigue lo que uno quiere 😉

    P.S.2
    El código en Github:
    elGuille-info/escribir-codigo-en-csharp: Escribir código en C#. Guía para los developers de Visual Basic (github.com)