Migracja z interfejsu Drive API

Ten dokument pokazuje, jak przenieść kod za pomocą interfejsu Drive API do zarządzania uprawnieniami do interfejsu Looker Studio API. W przypadku popularnych punktów końcowych interfejsu Drive API wyświetlany jest odpowiedni kod interfejsu Looker Studio API.

Files

W przypadku punktów końcowych plików interfejsu Drive API interfejs Looker Studio API ma tylko odpowiednik punktu końcowego Files: list.

Lista

API Metoda Punkt końcowy
Dysk POST /drive/v3/files
Looker Studio GET /v1/assets:search

Porównanie:

Dysk

const oAuthToken = '123' // This should be replaced with a valid OAuth token.
fetch(`https://www.googleapis.com/drive/v3/files`, {
  headers: {
    Authorization: `Bearer ${oAuthToken}`
  },
  method: "POST",
})

Looker Studio

const oAuthToken = '123' // This should be replaced with a valid OAuth token.
fetch(`https://datastudio.googleapis.com/v1/assets:search?assetTypes={ASSET_TYPE}`, {
  headers: {
    Authorization: `Bearer ${oAuthToken}`
  }
})

Zobacz zasoby do wyszukiwania.

Uprawnienia

Twórz, usuwaj i pobieraj

API Metoda Punkt końcowy
Dysk POST /drive/v3/files/fileId/permissions
Dysk DELETE /drive/v3/files/fileId/permissions/permissionId
Dysk GET /drive/v3/files/fileId/permissions/permissionId

W interfejsie Looker Studio API nie ma odpowiadających im punktów końcowych umożliwiających zarządzanie wieloma obiektami Permissions. Dla zasobu Looker Studio jest tylko 1 obiekt uprawnień. Taki obiekt zawsze istnieje.

Lista

Nie ma dopasowań 1:1 między Dyskiem a Looker Studio, ale punkty końcowe obsługują podobne cele. Główna różnica polega na tym, że plik na Dysku może mieć wiele obiektów uprawnień, a Looker Studio – tylko jeden.

API Metoda Punkt końcowy
Dysk GET /drive/v3/files/fileId/permissions
Looker Studio GET /v1/assets/assetId/permissions

Porównanie:

Dysk

Ten kod zawiera listę wszystkich obiektów uprawnień interfejsu Drive API. W zależności od kodu możesz wywoływać tę metodę wiele razy za pomocą tokenów podziału na strony (jak pokazano), aby mieć pewność, że widzisz wszystkie uprawnienia ustawione dla pliku.

const fileId = '123'; // This should be replaced with a valid Drive ID.
const oAuthToken = '123'; // This should be replaced with a valid OAuth token.
let nextPageToken = undefined;
let permissions = [];
do {
  const permissionsData = await fetch(`https://www.googleapis.com/drive/v3/files/${fileId}/permissions`, {
    headers: {
      Authorization: `Bearer ${oAuthToken}`
    }
  });
  nextPageToken = permissionsData.nextPageToken;
  permissions = permissions.concat(permissionsData.permissions)
} while (nextPageToken !== undefined);

Looker Studio

Dla zasobu Looker Studio jest tylko 1 obiekt uprawnień, więc nie musisz brać pod uwagę podziału na strony.

const oAuthToken = '123' // This should be replaced with a valid OAuth token.
const assetId = '123' // This should be replaced with a valid asset ID.
fetch(`https://datastudio.googleapis.com/v1/assets/{ASSET_ID}/permissions`, {
  headers: {
    Authorization: `Bearer ${oAuthToken}`
  }
}

Zobacz Uzyskiwanie uprawnień.

Aktualizuj

Jeśli chodzi o aktualizowanie uprawnień, interfejsy Looker Studio i Drive API mają bardzo podobne funkcje. Główna różnica polega na tym, że nie można ustawić uprawnienia expirationTime w przypadku uprawnienia Looker Studio.

API Metoda Punkt końcowy
Dysk PATCH /drive/v3/files/fileId/permissions/permissionId
Looker Studio PATCH /v1/assets/assetId/permissions

Porównanie:

Dysk

const fileId = '123'; // This should be replaced with a valid Drive ID.
const oAuthToken = '123'; // This should be replaced with a valid OAuth token.
const newPermissionsObject = {
  expirationTime: '...',
  role: 'owner', // Or any other option
}
fetch(`https://www.googleapis.com/drive/v3/files/${fileId}/permissions/permissionId`, {
  headers: {
    Authorization: `Bearer ${oAuthToken}`
  },
  method: "PATCH",
  body: JSON.stringify(newPermissionsObject)
})

Looker Studio

const oAuthToken = '123' // This should be replaced with a valid OAuth token.
const assetId = '123' // This should be replaced with a valid asset ID.
const newPermissionsObject = {
  permissions: {
    //...
  }
}

fetch(`https://datastudio.googleapis.com/v1/assets/${assetId}/permissions`, {
  headers: {
    Authorization: `Bearer ${oAuthToken}`
  },
  method: "PATCH",
  body: JSON.stringify({
    name: assetId,
    permissions: newPermissionsObject
  })
})

Alternatywne alternatywy dla konkretnych przypadków użycia znajdziesz tutaj: