Powiadomienie

Dostęp tylko w usłudze Google Ad Manager 360.

Dostęp do zasobników na dane Ad Managera

Jak pobierać pliki Przenoszenia danych

Ważne: na początku listopada 2024 r. zaczęliśmy przenosić uprawnienia dostępu do zasobników Przenoszenia danych w usłudze Ad Manager z Grup dyskusyjnych Google do uprawnień dla nowej roli użytkownika w usłudze Ad Manager. 

Szczegółowe informacje o harmonogramie migracji i kolejnych krokach znajdziesz w artykule Migracja uprawnień do Przenoszenia danych z Grup dyskusyjnych Google do uprawnień w usłudze Ad Manager.

Google Cloud Storage to osobna usługa Google, której Ad Manager używa jako repozytorium raportów Przenoszenia danychprzesyłanych zbiorczo identyfikatorów plików cookie odbiorców.

Z tego artykułu dowiesz się, jak korzystać ze standardowych technologii Google Cloud Storage do komunikowania się z konkretną konfiguracją miejsca na dane w chmurze Ad Managera. Podstawowym źródłem informacji o Google Cloud Storage jest jednak strona dla deweloperów tej usługi.

Metody

Dostęp do zasobników na dane w chmurze Ad Managera można uzyskać na trzy sposoby, według stopnia komplikacji:

  • W przeglądarce internetowej – wejdź na https://console.developers.google.com/storage/gdfp-[kod sieci Ad Managera].
  • Narzędzie wiersza poleceń gsutil oparte na języku Python udostępnia podobne do uniksowych polecenia do interakcji z zasobnikami na dane. Uwierzytelnianie dostępu do zasobnika jest wyodrębnione i obsługiwane automatycznie.
  • Interfejs API Google Cloud Storage to interfejs API o pełnym zakresie funkcji służący do manipulowania zasobnikiem na dane, dostępny przez interfejsy internetowe JSON i XML RESTowy. Biblioteki klienta API są dostępne do wielu popularnych środowisk programowania, m.in. Java, JavaScript, Python i Objective-C. Ten sposób jest najbardziej użyteczny, jeśli chcesz zarządzać zasobnikami na dane programowo, aby zintegrować je z aplikacją Google App Engine lub z aplikacją internetową w języku Java.

W tym artykule podano szczegółowe informacje o interfejsie API Google Cloud Storage. Dostęp przez przeglądarkę internetową i narzędzie gsutil jest łatwiejszy, dlatego zalecamy zapoznanie się w pierwszej kolejności właśnie z tymi metodami. Ich pełną dokumentację można znaleźć w witrynie dla deweloperów Google Cloud Storage.

Zarządzanie dostępem do zasobników na dane w usłudze Ad Manager

Uwaga: dostęp do zasobników miejsca na daqne w ramach funkcji Przenoszenie danych jest przenoszony z Grup dyskusyjnych Google do nowej roli użytkownika w usłudze Ad Manager. Dostęp przez Grupy dyskusyjne Google zostanie wycofany w styczniu 2025 r. Dowiedz się więcej o migracji

Nowy proces uzyskiwania dostępu do miejsca na dane na potrzeby funkcji Przenoszenie danych (dostępny od listopada 2024 r.)

Od listopada 2024 r. możesz zacząć przenosić użytkowników, którzy potrzebują dostępu do zasobników miejsca na dane w ramach funkcji Przenoszenie danych, z Grup dyskusyjnych Google do nowej roli użytkownika w usłudze Ad Manager. Domyślnie użytkownicy z rolą administratora będą mieć dostęp do zasobników miejsca na dane. Innych użytkowników możesz dodać do roli użytkownika z nowymi uprawnieniami „Wyświetlanie zasobników przenoszenia danych”. Dostęp na podstawie nowych uprawnień będzie dostępny od 3 grudnia 2024 r.Dowiedz się więcej o migracji

Stary proces uzyskiwania dostępu do miejsca na dane w ramach funkcji Przenoszenie danych (dostępny do stycznia 2025 r.)

Uwaga: jeśli chcesz mieć dostęp do miejsca na dane w funkcji przenoszenia danych, zapoznaj się z fazami migracji i podejmij odpowiednie działania przed styczniem 2025 r. 

Zasobniki na dane, z których korzysta Ad Manager, wchodzą w skład projektu miejsca w chmurze Google. Zasobniki na dane Ad Managera nie występują na Twojej liście projektów w Google Developers Console.

Aby skonfigurować funkcje zależne od zasobników na dane Ad Managera, skontaktuj się z przedstawicielem Google. Udostępni on grupę dyskusyjną Google, która posłuży Ci do zarządzania zasobnikami na dane.

Jeśli jesteś administratorem obecnej grupy dyskusyjnej Google w G Suite, możesz podać jej nazwę przedstawicielowi Google w ramach procesu włączania funkcji. Przedstawiciel pomoże Ci włączyć wszystkie funkcje, które używają zasobników na dane Ad Managera, za pomocą tej grupy dyskusyjnej.

Jeśli zarządzasz więcej niż 1 siecią Ad Managera z dostępem do Przenoszenia danych, poinformuj o tym przedstawiciela Google, aby zapewnił on konsolidację zarządzania sieciami. Dzięki temu jedna grupa dyskusyjna pozwoli zarządzać wszystkimi zasobnikami Przenoszenia danych w Twoich sieciach.

Grupy dyskusyjne Google, które nie należą do G Suite, nie mogą służyć do zarządzania zasobnikami na dane Ad Managera.

Korzystanie z interfejsu API Google Cloud Storage

Jeśli uznasz, że najbardziej odpowiada Ci dostęp przez interfejs API, zalecamy skonfigurowanie konta usługi Google Cloud Storage.

Konfigurowanie konta usługi Google Cloud Storage

W przypadku uzyskiwania dostępu do zasobnika na dane przez interfejs API lepiej jest skonfigurować konto usługi niż działać w kontekście użytkownika. Konta usługi upraszczają tworzenie aplikacji, ponieważ do uwierzytelniania służy klucz prywatny, a nie generowany dynamicznie token OAuth. Aby skonfigurować konto usługi:

  1. Otwórz Google Developers Console.

  2. Utwórz nowy projekt (lub wybierz już istniejący), który będzie nadrzędny wobec aplikacji, i go kliknij.

  3. (Opcjonalnie) Jeśli zamierzasz kopiować pliki z zasobnika na dane Ad Managera na własne konto Google Cloud Storage, kliknij Rozliczenia i ustawienia, by dodać do projektu źródło danych do rozliczeń.

  4. Utwórz nowy identyfikator klienta:

    1. Kliknij Interfejsy API i usługi > Dane logowania.

    2. Kliknij Utwórz nowy identyfikator klienta.

    3. Jako typ aplikacji wybierz Konto usługi, a potem kliknij Utwórz identyfikator klienta.

    4. Wygenerowany adres e-mail ma format [unikalny identyfikator]@developer.gserviceagccount.com. Skopiuj go i zapisz, aby dodać do swojej grupy dyskusyjnej Google.

    5. Kliknij Wygeneruj nowy klucz P12. Plik zostanie zapisany na Twoim komputerze. Używaj tego klucza w tworzonych aplikacjach, by uzyskiwać dostęp do interfejsu API w sposób podany w poniższym przykładowym kodzie.

  5. Dodaj adres e-mail do utworzonej przez siebie grupy dyskusyjnej Google, by zarządzać dostępem do zasobników na dane Ad Managera. Aby dodać konto usługi, zamiast „zaproś” kliknij Dodaj członków bezpośrednio. Jeśli nie masz odpowiednich uprawnień, poproś administratora grupy dyskusyjnej Google o dodanie adresu w Twoim imieniu.
Przykładowy kod

Google udostępnia przykłady kodu i biblioteki do Google Cloud Storage. Z poniższego przykładu w Javie służącego do odczytywania pliku z zasobnika na dane w chmurze Ad Managera możesz się dowiedzieć, gdzie w Twoim kodzie mogą występować komponenty skonfigurowane przez Ciebie podczas tworzenia konta usługi:

  • Nazwa projektu: nazwa projektu Google Cloud Storage.

  • Adres e-mail konta usługi: wygenerowany przez Ciebie adres.

  • Plik klucza P12: pobrany przez Ciebie plik.

  • Nazwa zasobnika: Google podaje tę nazwę, gdy włączasz funkcję, która używa zasobników na dane w chmurze Ad Managera.

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.security.GeneralSecurityException;
import java.util.Collections;

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.storage.Storage;
import com.google.api.services.storage.model.StorageObject;

public class GcsApiTest {
    /**
     * Nazwa projektu, w ramach którego utworzono konto usługi.
     * 
     * Ta informacja jest wyświetlana w Google Developers Console.
     */
    private static final String PROJECT_NAME = "nazwa projektu";

    /**
     * Adres e-mail dewelopera przypisany do konta usługi.
     * 
     * Adres ten jest generowany po utworzeniu identyfikatora klienta konta usługi
     * w Google Developers Console i można go znaleźć na stronie Dane
     * logowania. Adres ten trzeba też dodać do grupy dyskusyjnej Google,
     * która służy do kontrolowania dostępu do zasobnika na dane.
     */
    private static final String SERVICE_ACCOUNT_EMAIL = "adres e-mail konta usługi";

    /**
     * Zasobnik na operacje zapisu i odczytu danych.
     * 
     * Nazwa tego zasobnika została Ci podana przez menedżera
     * konta. Jest ona zgodna ze schematem „gdfp-12345678” lub
     * „gdfp_cookieupload_12345678” zależnie od tego, jakiego używasz dodatku Ad Managera.
     */
    private static final String BUCKET_NAME = "nazwa zasobnika";

    /**
     * Zakres OAuth 2.0 w Google Cloud Storage na zapis i odczyt. Powinien
     * odpowiadać uprawnieniom dostępu do zasobnika, jakie ma Twoja grupa
     * dyskusyjna Google, i nie może wykraczać poza nie (mogą się one np.
     * ograniczać do poziomu read_only).
     */
    private static final String STORAGE_SCOPE = 
        "https://www.googleapis.com/auth/devstorage.read_write";

    /**
     * Ścieżka dostępu do pliku key.p12 zapewniającego dostęp do zasobnika.
     * 
     * Ten plik jest tworzony razem z identyfikatorem klienta usługi. Jeśli
     * nie masz tego pliku, musisz wygenerować nowy klucz P12 klienta
     * w Google Developers Console.
     */
    private static final String KEY_P12 = "ścieżka dostępu do pliku klucza P12";

    /** Warstwa transportowa HTTP. */
    private HttpTransport httpTransport;
    private Storage storage;

    // constructor, sets up credentials and storage objects
    public GcsApiTest() {
	File p12File = new File(KEY_P12);

	try {
	    httpTransport = GoogleNetHttpTransport.newTrustedTransport();

	    GoogleCredential credential = new GoogleCredential.Builder()
		    .setTransport(httpTransport)
		    .setJsonFactory(JacksonFactory.getDefaultInstance())
		    .setServiceAccountId(SERVICE_ACCOUNT_EMAIL)
		    .setServiceAccountScopes(
			    Collections.singleton(STORAGE_SCOPE))
		    .setServiceAccountPrivateKeyFromP12File(p12File).build();
	    storage = new Storage.Builder(httpTransport,
		    JacksonFactory.getDefaultInstance(), credential)
		    .setApplicationName(PROJECT_NAME).build();
	} catch (GeneralSecurityException | IOException e1) {
	    e1.printStackTrace();
	    System.exit(1);
	}
    }

    /**
     * Metoda zwracania nazwy pierwszego pliku z zasobnika.
     * 
     * @return the name of the file, or null if the bucket is empty
     * @throws IOException
     */
    public String GetFirstFile() throws IOException {
	Storage.Objects.List listObjects = storage.objects().list(BUCKET_NAME);
	listObjects.setMaxResults(5L);
	com.google.api.services.storage.model.Objects objects = listObjects
		.execute();

	// empty bucket?
	if (null == objects.getItems() || objects.getItems().isEmpty()) {
	    System.out.println("Bucket \"" + BUCKET_NAME
		    + "\" empty or invalid.");
	    return null;
	}

	StorageObject object = objects.getItems().get(0);
	System.out.println("First object in bucket: \"" + object.getName()
		+ "\".");
	return object.getName();
    }

    /**
     * Metoda pobierania określonego pliku z zasobnika na dane.
     * 
     * @param filename
     *            Nazwa pliku, który powinien zostać pobrany.
     * @throws IOException
     */
    public void DownloadFile(String filename) throws IOException {
	Storage.Objects.Get getObject = storage.objects().get(BUCKET_NAME,
		filename);
	OutputStream os = new FileOutputStream(filename, true);
	getObject.getMediaHttpDownloader().setDirectDownloadEnabled(true);
	getObject.executeMediaAndDownloadTo(os);

	System.out.println("File \"" + filename + "\" downloaded.");
    }

    /**
     * Główna metoda wykonywania różnych testów.
     * 
     * @param args
     */
    public static void main(String[] args) {
	GcsApiTest gcsApiTest = new GcsApiTest();

	try {
	    String filename = gcsApiTest.GetFirstFile();
	    gcsApiTest.DownloadFile(filename);
	} catch (IOException e) {
	    System.out.println(e.getMessage());
	}
    }
}

Ograniczanie liczby żądań i połączenia równoczesne

Nie ma określonego limitu połączeń równoczesnych. W celu uniknięcia nadużyć Google ogranicza jednak liczbę żądań pobierania informacji w ramach Przenoszenia danych.

Najnowsze informacje znajdziesz w sekcji o Google Cloud Storage na oficjalnym blogu Google Code, a pytania możesz zadawać na forum dyskusyjnym Google Cloud Storage. W zależności od treści pytania dodawaj do tematu dopisek „Bug” (Błąd) lub „Feature Request” (Prośba o dodanie funkcji). Więcej informacji o Google Cloud Storage znajdziesz na stronie z najczęstszymi pytaniami dotyczącymi tej usługi.

Czy to było pomocne?

Jak możemy ją poprawić?
Szukaj
Wyczyść wyszukiwanie
Zamknij wyszukiwanie
Aplikacje Google
Menu główne