Skip to content

Service Management API API

by googleapis.com

OAuthHTTPSAnalytics
Open documentation ↗

Overview

Google Service Management allows service producers to publish their services on Google Cloud Platform so that they can be discovered and used by service consumers.

Service Management API is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 19 endpoints.

At a glance

Authentication
OAuth
HTTPS
Yes
CORS
Unknown
Category
Analytics
Base URL
https://servicemanagement.googleapis.com/
Version
v1
Endpoints
19
Spec updated
2023-04-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://servicemanagement.googleapis.com/v1/operations" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://servicemanagement.googleapis.com/v1/operations", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://servicemanagement.googleapis.com/v1/operations",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/v1/operationsLists service operations that match the specified filter in the request.
GET/v1/servicesLists managed services. Returns all public services. For authenticated users, also returns all services the calling user has "servicemanagement.services.get" pe
POST/v1/servicesCreates a new managed service. A managed service is immutable, and is subject to mandatory 30-day data retention. You cannot move a service or recreate it withi
GET/v1/services/{serviceName}Gets a managed service. Authentication is required unless the service is public.
DELETE/v1/services/{serviceName}Deletes a managed service. This method will change the service to the `Soft-Delete` state for 30 days. Within this period, service producers may call UndeleteSe
GET/v1/services/{serviceName}/configGets a service configuration (version) for a managed service.
GET/v1/services/{serviceName}/configsLists the history of the service configuration for a managed service, from the newest to the oldest.
POST/v1/services/{serviceName}/configsCreates a new service configuration (version) for a managed service. This method only stores the service configuration. To roll out the service configuration to
GET/v1/services/{serviceName}/configs/{configId}Gets a service configuration (version) for a managed service.
POST/v1/services/{serviceName}/configs:submitCreates a new service configuration (version) for a managed service based on user-supplied configuration source files (for example: OpenAPI Specification). This
GET/v1/services/{serviceName}/rolloutsLists the history of the service configuration rollouts for a managed service, from the newest to the oldest.
POST/v1/services/{serviceName}/rolloutsCreates a new service configuration rollout. Based on rollout, the Google Service Management will roll out the service configurations to different backend servi
GET/v1/services/{serviceName}/rollouts/{rolloutId}Gets a service configuration rollout.
POST/v1/services/{serviceName}:undeleteRevives a previously deleted managed service. The method restores the service using the configuration at the time the service was deleted. The target service mu
POST/v1/services:generateConfigReportGenerates and returns a report (errors, warnings and changes from existing configurations) associated with GenerateConfigReportRequest.new_value If GenerateConf
GET/v1/{name}Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
POST/v1/{resource}:getIamPolicyGets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
POST/v1/{resource}:setIamPolicySets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` erro
POST/v1/{resource}:testIamPermissionsReturns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND`

Questions

Does the Service Management API API need an API key?

Yes. The Service Management API API uses OAuth authentication; the documentation explains how to get credentials.

Does the Service Management API API support HTTPS?

Yes, the Service Management API API is served over HTTPS.

How many endpoints does the Service Management API API have?

Its OpenAPI description lists 19 endpoints in version v1. All of them are shown on this page.

What are alternatives to the Service Management API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).