WebAPI samples (#1423)

fthobe · fthobe · commit de929bb133fc · 2026-01-02T18:32:40.000+01:00
Based on previous work by @nickevansuk - Replace Google Knowledge Graph API with YouTube API (#2635) - Some minor bugfixes to end up with compliant json Closes: #1423 Superseedes: #2635
diff --git a/data/ext/pending/issue-1423-examples.txt b/data/ext/pending/issue-1423-examples.txt
@@ -18,11 +18,11 @@ JSON:
 {
   "@context": "https://schema.org/",
   "@type": "WebAPI",
-  "name": "Google Knowledge Graph Search API",
-  "description": "The Knowledge Graph Search API lets you find entities in the Google Knowledge Graph. The API uses standard schema.org types and is compliant with the JSON-LD specification.",
-  "url": "https://developers.google.com/knowledge-graph/",
-  "documentation": "https://developers.google.com/knowledge-graph/reference/rest/v1",
-  "termsOfService": "https://developers.google.com/knowledge-graph/terms",
+  "name": "YouTube API",
+  "description": "The YouTube Data API lets you incorporate functions normally executed on the YouTube website into your own website or application. The following sections identify the different types of resources that you can retrieve using the API. The API also supports methods to insert, update, or delete many of these resources.",
+  "url": "https://www.googleapis.com/youtube/v3",
+  "documentation": "https://developers.google.com/youtube/v3/docs",
+  "termsOfService": "https://developers.google.com/youtube/terms/api-services-terms-of-service",
   "provider": {
     "@type": "Organization",
     "name": "Google Inc."
@@ -51,25 +51,20 @@ JSON:
 {
   "@context": "https://schema.org/",
   "@type": "WebAPI",
-  "name": "Google Knowledge Graph Search API",
-  "description": "The Knowledge Graph Search API lets you find entities in the Google Knowledge Graph. The API uses standard schema.org types and is compliant with the JSON-LD specification.",
-  "documentation": "https://developers.google.com/knowledge-graph/reference/rest/v1",
+  "name": "YouTube API",
+  "description": "The YouTube Data API lets you incorporate functions normally executed on the YouTube website into your own website or application. The following sections identify the different types of resources that you can retrieve using the API. The API also supports methods to insert, update, or delete many of these resources.",
+  "documentation": "https://developers.google.com/youtube/v3/docs",
   "endpointDescription": [
     {
       "@type": "CreativeWork",
       "encodingFormat": "application/json",
-      "url": "https://kgsearch.googleapis.com/$discovery/rest?version=v1"
-    },
-    {
-      "@type": "CreativeWork",
-      "encodingFormat": "application/vnd.oai.openapi+json;version=3.0",
-      "url": "https://api.apis.guru/v2/specs/googleapis.com/kgsearch/v1/openapi.json"
+      "url": "https://www.googleapis.com/youtube/v3"
     }
   ],
-  "url": "https://developers.google.com/knowledge-graph/",
-  "termsOfService": "https://developers.google.com/knowledge-graph/terms",
+  "url": "https://developers.google.com/youtube/v3",
+  "termsOfService": "https://developers.google.com/youtube/terms/api-services-terms-of-service",
   "logo": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
-  "license": "https://creativecommons.org/licenses/by/3.0/",
+  "license": "https://creativecommons.org/licenses/by/4.0/",
   "provider": {
     "@type": "Organization",
     "name": "Google Inc.",
@@ -79,9 +74,9 @@ JSON:
         "name": "Google",
         "url": "https://google.com"
       }
-    ],
+    ]
   },
-  "version": "1.0.0",
+  "version": "3.0.0",
   "apiTransport": [
     "HTTP",
     "HTTPS"
@@ -93,7 +88,7 @@ JSON:
     {
       "@type": "ConsumeAction",
       "name": "API Client Registration",
-      "target": "https://developers.google.com/knowledge-graph/how-tos/authorizing"
+      "target": "https://console.cloud.google.com/apis/credentials"
     }
   ]
 }
diff --git a/data/ext/pending/issue-1423.ttl b/data/ext/pending/issue-1423.ttl
@@ -27,7 +27,6 @@ The [[documentation]] and [[endpointDescription]] properties give specific detai
     rdfs:label "endpointDescription" ;
     :category "issue-1423" ;
     :domainIncludes :WebAPI ;
-    :isPartOf <http://pending.schema.org> ;
     :rangeIncludes :CreativeWork ;
     :source <https://github.com/schemaorg/schemaorg/issues/1423> ;
     rdfs:comment """Machine-readable API definition of the services available via the [[WebAPI]], including their operations, parameters etc.
@@ -49,7 +48,6 @@ Machine-readable formats include OpenAPI (Swagger) description, an OGC GetCapabi
     :category "issue-1423" ;
     :domainIncludes :CreativeWork,
         :WebAPI ;
-    :isPartOf <http://pending.schema.org> ;
     :rangeIncludes :URL ;
     :source <https://github.com/schemaorg/schemaorg/issues/1423> ;
     rdfs:comment """The URL reference of an established standard to which the [[Thing]] described conforms.
@@ -60,7 +58,6 @@ Machine-readable formats include OpenAPI (Swagger) description, an OGC GetCapabi
     :category "issue-1423" ;
     :domainIncludes :Dataset,
         :DataDownload ;
-    :isPartOf <http://pending.schema.org> ;
     :rangeIncludes :WebAPI ;
     :source <https://github.com/schemaorg/schemaorg/issues/1423> ;
     rdfs:comment "An API that provides access to the dataset." .
@@ -69,7 +66,6 @@ Machine-readable formats include OpenAPI (Swagger) description, an OGC GetCapabi
     rdfs:label "apiTransport" ;
     :category "issue-1423" ;
     :domainIncludes :WebAPI ;
-    :isPartOf <http://pending.schema.org> ;
     :rangeIncludes :Text ;
     :source <https://github.com/schemaorg/schemaorg/issues/1423> ;
     rdfs:comment "The type of transport used for the API, such as `HTTP`, `HTTPS`, `SMTP`, `MQTT`, `WS`, `WSS`, `gRPC`." .
