Лучшие практики и ограничения

Учитывайте эти рекомендации при использовании BatchJobService .

Повышение пропускной способности

  • Меньшее количество крупных рабочих мест предпочтительнее множества мелких рабочих мест.

  • Упорядочите загруженные операции по типу операции. Например, если ваше задание содержит операции по добавлению кампаний, групп объявлений и критериев групп объявлений, расположите операции в загрузке так, чтобы сначала были все операции кампании , затем все операции группы объявлений и, наконец, все операции группы объявлений. критериальные операции .

  • В операциях одного типа можно повысить производительность, сгруппировав их по родительскому ресурсу. Например, если у вас есть ряд объектов AdGroupCriterionOperation , может быть более эффективно группировать операции по группам объявлений, а не смешивать операции, которые влияют на критерии группы объявлений в разных группах объявлений.

Избегайте проблем с параллелизмом

  • При отправке нескольких одновременных заданий для одной и той же учетной записи постарайтесь снизить вероятность одновременной работы заданий с одними и теми же объектами, сохраняя при этом большие размеры заданий. Многие незавершенные задания (со статусом RUNNING ), которые пытаются изменить один и тот же набор объектов, могут привести к состояниям, подобным тупику, что приводит к серьезному замедлению работы и даже к сбоям в работе.

  • Не отправляйте несколько операций, которые изменяют один и тот же объект в одном задании, поскольку результат может быть непредсказуемым.

Оптимальное получение результатов

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

  • Не получайте более 1000 результатов на страницу. Сервер может вернуть меньшее количество данных из-за нагрузки или других факторов.

  • Порядок результатов будет таким же, как и порядок загрузки.

Дополнительные рекомендации по использованию

  • Вы можете установить верхнюю границу времени, в течение которого пакетное задание может выполняться до его отмены. При создании нового пакетного задания установите в поле metadata.execution_limit_seconds желаемое ограничение по времени в секундах. Ограничение по времени по умолчанию отсутствует, если не задан metadata.execution_limit_seconds .

  • Рекомендуется добавлять не более 1000 операций на каждый AddBatchJobOperationsRequest и использовать sequence_token для загрузки остальных операций в то же задание. В зависимости от содержимого операций слишком много операций в одном AddBatchJobOperationsRequest может привести к ошибке REQUEST_TOO_LARGE . Эту ошибку можно устранить, уменьшив количество операций и повторив AddBatchJobOperationsRequest .

Ограничения

  • Каждое BatchJob поддерживает до миллиона операций.

  • В каждой учетной записи одновременно может быть до 100 активных или ожидающих заданий.

  • Ожидающие задания старше 7 дней автоматически удаляются.

  • Максимальный размер каждого AddBatchJobOperationsRequest составляет 10 484 504 байта. Если вы превысите это значение, вы получите INTERNAL_ERROR . Вы можете определить размер запроса перед отправкой и принять соответствующие меры, если он слишком велик.

    Ява

    
    static final int MAX_REQUEST_BYTES = 10_484_504;
    
    ... (code to get the request object)
    
    int sizeInBytes = request.getSerializedSize();
    

    Питон

    
    from google.ads.googleads.client import GoogleAdsClient
    
    MAX_REQUEST_BYTES = 10484504
    
    ... (code to get the request object)
    
    size_in_bytes = request._pb.ByteSize()
    

    Руби

    
    require 'google/ads/google_ads'
    
    MAX_REQUEST_BYTES = 10484504
    
    ... (code to get the request object)
    
    size_in_bytes = request.to_proto.bytesize
    

    PHP

    
    use Google\Ads\GoogleAds\V16\Resources\Campaign;
    
    const MAX_REQUEST_BYTES = 10484504;
    
    ... (code to get the request object)
    
    $size_in_bytes = $campaign->byteSize() . PHP_EOL;
    

    .СЕТЬ

    
    using Google.Protobuf;
    const int MAX_REQUEST_BYTES = 10484504;
    
    ... (code to get the request object)
    
    int sizeInBytes = request.ToByteArray().Length;
    

    Перл

    
    use Devel::Size qw(total_size);
    use constant MAX_REQUEST_BYTES => 10484504;
    
    ... (code to get the request object)
    
    my $size_in_bytes = total_size($request);
    
,

Учитывайте эти рекомендации при использовании BatchJobService .

Повышение пропускной способности

  • Меньшее количество крупных рабочих мест предпочтительнее множества мелких рабочих мест.

  • Упорядочите загруженные операции по типу операции. Например, если ваше задание содержит операции по добавлению кампаний, групп объявлений и критериев групп объявлений, расположите операции в загрузке так, чтобы сначала были все операции кампании , затем все операции группы объявлений и, наконец, все операции группы объявлений. критериальные операции .

  • В операциях одного типа можно повысить производительность, сгруппировав их по родительскому ресурсу. Например, если у вас есть ряд объектов AdGroupCriterionOperation , может быть более эффективно группировать операции по группам объявлений, а не смешивать операции, которые влияют на критерии группы объявлений в разных группах объявлений.

Избегайте проблем с параллелизмом

  • При отправке нескольких одновременных заданий для одной и той же учетной записи постарайтесь снизить вероятность одновременной работы заданий с одними и теми же объектами, сохраняя при этом большие размеры заданий. Многие незавершенные задания (со статусом RUNNING ), которые пытаются изменить один и тот же набор объектов, могут привести к состояниям, подобным тупику, что приводит к серьезному замедлению работы и даже к сбоям в работе.

  • Не отправляйте несколько операций, которые изменяют один и тот же объект в одном задании, поскольку результат может быть непредсказуемым.

Оптимальное получение результатов

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

  • Не получайте более 1000 результатов на страницу. Сервер может вернуть меньшее количество данных из-за нагрузки или других факторов.

  • Порядок результатов будет таким же, как и порядок загрузки.

Дополнительные рекомендации по использованию

  • Вы можете установить верхнюю границу времени, в течение которого пакетное задание может выполняться до его отмены. При создании нового пакетного задания установите в поле metadata.execution_limit_seconds желаемое ограничение по времени в секундах. Ограничение по времени по умолчанию отсутствует, если не задан metadata.execution_limit_seconds .

  • Рекомендуется добавлять не более 1000 операций на каждый AddBatchJobOperationsRequest и использовать sequence_token для загрузки остальных операций в то же задание. В зависимости от содержимого операций слишком много операций в одном AddBatchJobOperationsRequest может привести к ошибке REQUEST_TOO_LARGE . Эту ошибку можно устранить, уменьшив количество операций и повторив AddBatchJobOperationsRequest .

Ограничения

  • Каждое BatchJob поддерживает до миллиона операций.

  • В каждой учетной записи одновременно может быть до 100 активных или ожидающих заданий.

  • Ожидающие задания старше 7 дней автоматически удаляются.

  • Максимальный размер каждого AddBatchJobOperationsRequest составляет 10 484 504 байта. Если вы превысите это значение, вы получите INTERNAL_ERROR . Вы можете определить размер запроса перед отправкой и принять соответствующие меры, если он слишком велик.

    Ява

    
    static final int MAX_REQUEST_BYTES = 10_484_504;
    
    ... (code to get the request object)
    
    int sizeInBytes = request.getSerializedSize();
    

    Питон

    
    from google.ads.googleads.client import GoogleAdsClient
    
    MAX_REQUEST_BYTES = 10484504
    
    ... (code to get the request object)
    
    size_in_bytes = request._pb.ByteSize()
    

    Руби

    
    require 'google/ads/google_ads'
    
    MAX_REQUEST_BYTES = 10484504
    
    ... (code to get the request object)
    
    size_in_bytes = request.to_proto.bytesize
    

    PHP

    
    use Google\Ads\GoogleAds\V16\Resources\Campaign;
    
    const MAX_REQUEST_BYTES = 10484504;
    
    ... (code to get the request object)
    
    $size_in_bytes = $campaign->byteSize() . PHP_EOL;
    

    .СЕТЬ

    
    using Google.Protobuf;
    const int MAX_REQUEST_BYTES = 10484504;
    
    ... (code to get the request object)
    
    int sizeInBytes = request.ToByteArray().Length;
    

    Перл

    
    use Devel::Size qw(total_size);
    use constant MAX_REQUEST_BYTES => 10484504;
    
    ... (code to get the request object)
    
    my $size_in_bytes = total_size($request);