Comienza a usar la API de Service Consumer Management
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La página describe los pasos que deben completarse antes de que pueda comenzar a utilizar la API de administración de consumidores de servicios. Se supone que ya tienes un proyecto deGoogle Cloud y un servicio administrado (como un servicio administrado creado con Cloud Endpoints) en ese proyecto, y que sabes usar las Unidades de usuario.
Activa el servicio
Si bien la API de Service Consumer Management te ayuda a administrar el uso de tus propios servicios administrados, también es un servicio en sí mismo. Por lo tanto, antes de poder usarlo, debes activar la API de Service Consumer Management para el proyecto Google Cloud que aloja tu servicio administrado. Este proyecto se conoce como un proyecto del productor de servicios.
La forma más sencilla de habilitar la API de Service Consumer Management para tu proyecto de productor de servicios es usar la consola deGoogle Cloud .
De manera alternativa, puedes habilitarla desde la linea de comandos o de manera programática. Puedes encontrar más información en Habilita e inhabilita servicios.
Configura los permisos
Una vez que la API de Administración de consumidores de servicios esté habilitada para su proyecto de productor de servicios, debe crear su propia identidad de servicio y otorgarle permisos sobre sus recursos a fin de poder crear proyectos de usuario en sus carpetas y configurar la cuenta de facturación correcta en los proyectos de usuarios. Estas acciones se ejecutan a través de una cuenta de servicio propiedad de la API de Administración de consumidores de servicios, que se especifica en el siguiente formato:
En ese formato, PROJECT_NUMBER es el número de proyecto correspondiente a su proyecto de productor de servicios que activó el servicio de Administración de consumidores de servicios.
El resto de esta guía utiliza GCM_SA para representar la cuenta de servicio de la API de Administración de consumidores de servicios.
Puedes usar los siguientes comandos para generar la identidad del servicio.
Asegúrate de tener una carpeta para almacenar los proyectos de inquilino: necesitarás tener una Organización para crear carpetas dentro del proyecto del productor de servicios. Si no tienes una carpeta, sigue las instrucciones en Crea y administra carpetas para crear una. Su carpeta tendrá un valor FOLDER_ID basado en un número entero.
En la carpeta, asigna la función de Creador o eliminador de proyectos a la cuenta de servicio de la API de Service Consumer Management. Sigue las instrucciones en Configura el acceso a las carpetas para agregar la función de creador de proyectos y eliminador de proyectos, y usa GCM_SA como el usuario.
Configura los permisos de la cuenta de facturación
Asegúrate de tener una cuenta de facturación que pueda compartirse para los proyectos de inquilino. Si no tienes una cuenta de facturación, consulta Crea, modifica o cierra una cuenta de facturación a fin de obtener instrucciones para crear una.
Sigue las instrucciones para agregar la función de usuario de la cuenta de facturación a GCM_SA.
Requisitos de los recursos
La API de Service Consumer Management crea proyectos de inquilino por ti; por lo tanto, asegúrate de tener suficiente cuota para crearlos.
Consulta la documentación de límites de proyectos para saber cuántos proyectos se pueden crear de forma predeterminada y solicitar aumentos a ese límite.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Getting Started with the Service Consumer Management API\n\nThe page describes the steps that need to be completed before you\ncan start to use the Service Consumer Management API. It assumes that you already have a\nGoogle Cloud project and a [managed service](/service-infrastructure/docs/glossary#managed)\n(such as a managed service created using [Cloud Endpoints](/endpoints/docs)) in\nthat project, and that you understand\n[Tenancy Units](/service-infrastructure/docs/glossary#tenancy).\n\nActivating the service\n----------------------\n\nWhile the Service Consumer Management API helps you to manage the usage of your own\n[managed services](/service-infrastructure/docs/glossary#managed), it is also a service\nitself. Therefore, before you can use it, you must activate the\nService Consumer Management API for the Google Cloud project that hosts your managed\nservice. This project is known as a [service producer](/service-infrastructure/docs/glossary#producer)\nproject.\n\nThe simplest way to enable the Service Consumer Management API for your service\nproducer project is to use the\n[Google Cloud console](https://console.cloud.google.com/apis/api/serviceconsumermanagement.googleapis.com).\nAlternatively, you can enable it from the command line or programmatically. You\ncan find out more in\n[Enabling and Disabling Services](/service-usage/docs/enable-disable).\n\nSetting permissions\n-------------------\n\nAfter the Service Consumer Management API is enabled for your service producer\nproject, you must create your own service identity and grant it permissions on\nyour resources so that it can create [tenant projects](/service-infrastructure/docs/glossary#tenant) in\nyour folders and set up the correct billing account on tenant projects. These\nactions are executed by a service account owned by the Service Consumer Management\nAPI, which is specified in the following format: \n\n```\nservice-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com\n```\n\nwhere *PROJECT_NUMBER* is the project number for your service producer project\nthat activated the Service Consumer Management service.\n\nThe remainder of this guide uses *GCM_SA* to represent the\nService Consumer Management API service account.\n\nYou can use the following commands to generate the service identity.\n\n1. Login with your user account.\n\n```\ngcloud auth login\n```\n\n1. Generate the service identity.\n\n```\ngcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID\n```\n\n### Setting folder permissions\n\n1. Ensure that you have a folder for holding your tenant projects: you'll need\n to have an [Organization](/resource-manager/docs/creating-managing-organization)\n to create folders within your service producer project. If you don't have a\n folder, follow the instructions in\n [Creating and Managing Folders](/resource-manager/docs/creating-managing-folders#create-folder)\n to create one. Your folder will have an integer based *FOLDER_ID*.\n\n2. On your folder, assign the **Project Creator/Deleter** role to the\n Service Consumer Management API service account. Follow the instructions in\n [Configuring Access to Folders](/resource-manager/docs/creating-managing-folders#configuring_access_to_folders)\n to add the **Project Creator** and **Project Deleter** role, using *GCM_SA* as\n the user.\n\n### Setting billing account permissions\n\n1. Ensure that you have a billing account that can be shared for tenant\n projects. If you don't have a billing account, see\n [Create, Modify, or Close a Billing Account](/billing/docs/how-to/manage-billing-account)\n for instructions to create one.\n\n2. Follow the\n [instructions](/billing/docs/how-to/billing-access)\n to add the **Billing Account User** role to *GCM_SA*.\n\nResource requirements\n---------------------\n\n- The Service Consumer Management API creates [tenant projects](/service-infrastructure/docs/glossary#tenant) on your behalf, so ensure you have enough quota to create them.\n- See the [project limits](https://cloud.google.com/resource-manager/docs/limits#project-limits) documentation to know how many projects can be created by default and to request increases to that limit."]]
