Что такое Google API Discovery?

Question

У меня возникли проблемы с пониманием концепции «открытия API», используемой в продуктах и ​​услугах Google. Вот некоторые Python код, который использует указанную услугу открытия доступа к Google Cloud Зрение:

from googleapiclient.discovery import build 
from oauth2client.client import GoogleCredentials 
… 
API_DISCOVERY_FILE = 'https://vision.googleapis.com/$discovery/rest?version=v1' 
hlh = httplib2.Http() 
credentials = GoogleCredentials.get_application_default().create_scoped(
    ['https://www.googleapis.com/auth/cloud-platform']) 
credentials.authorize(hlh) 
service = build(serviceName='vision', version='v1', http=hlh, discoveryServiceUrl=API_DISCOVERY_FILE) 
service_request = service.images().annotate(body={ <more JSON code here> }) 

Вот еще один фрагмент кода Python, который также получает доступ к Google Cloud Vision, но не использует обнаружение API и работает просто отлично:

import requests 
… 
ENDPOINT_URL = 'https://vision.googleapis.com/v1/images:annotate' 
response = requests.post(ENDPOINT_URL, 
    data=make_image_data(image_filenames), 
    params={'key': api_key}, 
    headers={'Content-Type': 'application/json'}) 

Что я не могу обернуть вокруг этого вопроса: вам нужно знать детали API, которые вы собираетесь звонить, чтобы вы могли адаптировать вызов; это очевидно. Итак, как бы обнаружение API помогло вам во время вызова, после того, как вы уже подготовили код для вызова этого API?

PS: Я смотрю на следующие ресурсы до публикации этого вопроса:
https://developers.google.com/discovery/v1/getting_started
https://developers.google.com/discovery/v1/using
Я видел this ответил на вопрос, но хотел бы получить дополнительную проницательность.

Answer 1

Примечание: Мне не хватает знания API Google, о котором вы упоминаете.

Вам необходимо знать детали API, которые вы собираетесь звонить , чтобы вы могли настроить вызов; это очевидно.

Теоретически для меня это требуется только для самого первого вызова, который был бы вызовом стартовой службы, которая, например, перечислила бы ряд ресурсов. Оттуда вы можете иметь ветки к основным ресурсам и их разрешенные методы (глаголы, если хотите). Таким образом, этот пример иллюстрирует структуру, подобную дереву. Если вы предоставляете графический интерфейс для навигации по этой возможности обнаружения общим способом, человек сможет решить, что делать.

На практике это довольно сложно сделать, когда у вас есть огромное количество ресурсов и всевозможные взаимосвязи между ними.